File: README.TXT EXAMS Exposure Analysis Modeling System Version 2.98.04.06 U.S. EPA Release, April 2005 Center for Exposure Assessment Modeling (CEAM) National Exposure Research Lab - Ecosystems Research Division Office of Research and Development (ORD) U.S. Environmental Protection Agency (U.S. EPA) 960 College Station Road Athens, Georgia 30605-2700 706/355-8400 _____________________________________________________________________________ CONTENTS Introduction Documentation Installation Completing and Testing the Installation Selected File Names and Content Development System Routine Execution Technical Help Contact _____________________________________________________________________________ INTRODUCTION The Exposure Analysis Modeling System, first published in 1982 (EPA-600/3-82-023), provides interactive computer software for formulating aquatic ecosystem models and rapidly evaluating the fate, transport, and exposure concentrations of synthetic organic chemicals - pesticides, industrial materials, and leachates from disposal sites. EXAMS contains an integrated Database Management System (DBMS) specifically designed for storage and management of project databases required by the software. User interaction is provided by a full-featured Command Line Interface (CLI), context-sensitive help menus, an on-line data dictionary and CLI user's guide, and plotting capabilities for review of output data. EXAMS provides 20 output tables that document the input data sets and provide integrated results summaries for aid in ecological risk assessments. _____________________________________________________________________________ DOCUMENTATION It is recommended that the user obtain and refer to the documents listed below to operate and apply the EXAMS model system. Copies of the following documents are included within the Internet distribution file Install_EXAMS.EXE. Document Name(s) File Name(s) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~ EXAMS model system general execution and README.TXT user support guide EXAMS Model System Release Notes RELEASE.TXT (Enhancements/updates/additions; may not be covered in user manual file) EXAMS Model System Abstract ABSTRACT.TXT EXAMS User's Manual "Exposure Analysis EXAMSREVG.PDF Modeling System (EXAMS): User Manual and System Documentation" EPA/600/R-00/081 The EXAMS User's Manual can be viewed or downloaded from the U.S. EPA CEAM Internet site (http://www.epa.gov/ceampubl/swater/exams/exams29804/EXAMREVG.PDF): Files with a file name extension of .PDF are in Adobe Acrobat format and require Adobe Acrobat Reader software available at no charge from http://www.adobe.com/. _____________________________________________________________________________ INSTALLATION Installation Requirements: CD-ROM drive (if installed from CD-ROM) Approximately 8 MB available hard disk storage Windows 9x/NT/2K/XP operating system. Run Time Requirements: DOS or operating system capable of emulating a DOS console (e.g., Win9x/NT/2K/XP) Approximately 8 MB available hard disk storage. The EXAMS installation file, Install_EXAMS.EXE, may be acquired either from the Internet or CD-ROM. Save the installation file to a local disk before running the installation program. To install EXAMS: Close all applications and click on the installation program "Install_EXAMS.EXE". Follow the instructions presented by the installation program. _____________________________________________________________________________ TESTING THE INSTALLATION The file "TEST.EXA" is an input command file that verifies successful installation by exercising a substantial subset of EXAMS' capabilities, followed by comparison to the expected output from the example simulation as contained in the file "TESTOUT.XMS" supplied with the program. The following steps are designed to test the EXAMS installation and should be executed from the MS-DOS Command Prompt: Step Description/Action ~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1) Set the default drive to the disk containing the model system sub-directory/folder: A:\> C: -- 2) Change the Windows DOS console default sub-directory/folder to the sub-directory/folder selected during installation as the target sub-directory/folder (e.g., C:\EXAMS or C:\PIRANHA\EXAMS). Use the DOS CD (change directory) command at the console prompt: C:\> CD \EXAMS --------- 3) Execute the EXAMS model: C:\EXAMS> EXAMS ----- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ EXAMS version 2.98.04.06 run time initial information status screen and run-time prompt displayed here. Follow and respond to the input or command prompts displayed on the monitor screen. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Welcome to EXAMS Release 2.98.04 Exposure Analysis Modeling System Technical Contact: Lawrence A. Burns, Ph.D. U.S. Environmental Protection Agency 960 College Station Road Athens, GA 30605-2700 USA Phone: (706) 355-8119 (Fax) 355-8104 Email: burns.lawrence@epa.gov Latest Maintenance 2005-04-05 Type HELP and press the RETURN key for command names, HELP USER for a summary of command functions, HELP PAGES for a list of information pages, or HELP EXAMS for introductory information. Please stand by while EXAMS checks the computational precision of this computer and initializes the Activity Data Base. EXAMS-> DO TEST ------- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ EXAMS 2.98.04.06 run time diagnostic and information status screens, messages, and run-time prompts may be displayed while the model executes. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When the EXAMS model finishes executing, compare the output file supplied to that produced -- for example: C:\EXAMS> FC OUT_TEST\TESTOUT.XMS REPORT.XMS ---------------------------------- If no differences were found between these files then installation was completed successfully. _____________________________________________________________________________ DEVELOPMENT SYSTEM The following list describes the language and program development tools used by the U.S. EPA Center for Exposure Assessment Modeling to build version 2.98.04.06 of the microcomputer implementation of the EXAMS model system. Also shown are the recommended minimum hardware and software configuration for implementation and execution of this model system and all related support files and programs. If the system upon which EXAMS is to be installed does not conform to minimum specifications, EXAMS WILL NOT execute properly. Development System: Hardware System: Fully IBM compatible 80386, 80486, or 80586/Pentium Language: Fortran 95 Operating System: Properly configured, this model system should work on hardware platforms within a Windows console under Windows 98, NT, 2000, or XP. Compiler: Lahey/Fujitsu Fortran 95 (LF95) Link Editor: PharLap 386|Link 9.2 Overlay Structure: None - linked as flat memory model and program Hard Disk Drive: 100M byte drive recommended with 20M bytes free Installation Size: Run Time: Approx. 10M bytes Run time size: After installation, up to approximately 1M bytes, plus space for user input data or command files, output, and temporary files produced by model system. Numerical Coprocessor: Required. _____________________________________________________________________________ ROUTINE EXECUTION Introduction ~~~~~~~~~~~~ Complete the installation process to make the full or any portion of the EXAMS model system and related files resident on a hard (usually designated as "C:") or virtual disk drive. This includes at a minimum EXAMS.EXE, EXAMS.DAF, and OZONE.DAF, although in the absence of OZONE.DAF EXAMS will use zonal mean values (at 5 degree latitude intervals) for stratospheric ozone concentrations. Routine Execution Steps ~~~~~~~~~~~~~~~~~~~~~~~ The following steps are designed to be executed from within a Windows DOS console running under Windows 98/NT/2000/xP. It is also possible to execute the EXAMS model by clicking on the My Computer icon from the user's Windows desktop, browsing for and clicking on the EXAMS.EXE file. Step Description/Action ~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1) Set the default drive to the disk containing the EXAMS model system sub-directory/folder. For example: A:\> C: -- 2) Change the default sub-directory/folder to the sub-directory/folder designated by the user during the installation program as the installation sub-directory/folder (e.g., C:\EXAMS or C:\PIRANHA\EXAMS). Use the DOS CD (change directory) command at the Windows console (DOS system) prompt: C:\> CD \EXAMS --------- 3) To execute the EXAMS model, type: C:\EXAMS> EXAMS ----- The prompt "EXAMS->" will appear on the monitor screen to prompt the user for information, data, commands, or a "DO" command file needed for this run of the model. At this prompt, the user can enter valid EXAMS model/program commands. Refer to the user's manual for further information on valid command usage and syntax. Viewing Output Results ~~~~~~~~~~~~~~~~~~~~~~ After executing an EXAMS model system executable task image file, results can be viewed in tabular format and as data plots using EXAMS commands. After exiting EXAMS and returning to the DOS prompt, the user can view those output files (e.g., REPORT.XMS), if any, produced by the execution of the program or model if and only if the file is in ASCII text (non-binary) format. Results can be viewed by scrolling through the output file that was (1) a result of model or program execution or (2) named by the user at a run-time prompt using EXAMS' "print," "write," or "plot" commands. File Name and Path Specifications ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ An input or output file name path specification or file name, as typed at a run time prompt or as specified by the user within an EXAMS "DO" input command file, may in general be given any arbitrary name convenient to the user, although it must be a unique and valid Windows path or file name. A file name should assist with identifying the contents or purpose of a file (e.g., INPUT.DAT, OUTPUT.LST, Test_the_Program.now). An input command or data file name must also be a valid EXAMS file name-- either furnished with the distribution package (see the SELECTED FILE NAMES AND CONTENT section) or created, designated, and named by the user. A file name typed at a run time prompt or specified within an EXAMS "DO" command input file will be processed and executed in a given run of the model. An EXAMS "DO" input command file, for batch processing of the EXAMS model, should only be created or modified using an editor program that can read and save a file to disk in ASCII text (non-binary) format. A "DO" input command file can be used to execute the EXAMS model in batch mode; it must contain valid responses to the interactive prompts presented during execution of the EXAMS model. Using an input "DO" command file allows the program to run without user intervention or interruption, and may be set up for multiple response or input data. This technique is useful to execute the model repeatedly while changing, for example, one input parameter between model executions without having to enter or modify other parameters, and for linkage to multi-year simulations from PRZM. An EXAMS model input "DO" command file name includes a conventional DOS 1- to 3-character file name extension. However, the file name extension ".EXA" is assumed for "DO" command files. If a file name extension other than ".EXA" is used for a "DO" command file, the extension must be entered with the file name at the EXAMS program prompt. Examples: EXAMS-> DO TEST (file name is actually TEST.EXA) EXAMS-> DO MYDATA.DAT EXAMS-> DO Test_the_Program.now An EXAMS "DO" command file will be processed during the execution of the EXAMS program. _____________________________________________________________________________ TECHNICAL HELP CONTACT For questions or information concerning the distribution or installation of EXAMS software, documentation, or data please contact CEAM at: Phone: 706-355-8400 Fax: 706-355-8104 E-mail: ceam@epamail.epa.gov Mail: Center for Exposure Assessment Modeling (CEAM) National Exposure Research Laboratory - Ecosystems Research Division U.S. Environmental Protection Agency (U.S. EPA) 960 College Station Road Athens, Georgia 30605-2700 CEAM operates and maintains a listserver system named CEAM-USERS. The CEAM- USERS listserver is an automated mailing list system which broadcasts up-to- date information concerning CEAM software product updates and releases as well as hints on software installation and use. Subscribers may broadcast messages to other list subscribers to ask and answer questions about exposure assessment modeling topics. Instructions for subscribing, posting messages, and managing membership setting are available on the CEAM Web site at the URL: http://www.epa.gov/ceampubl/listserv.htm Comments on any aspect of EXAMS can be e-mailed to: Lawrence A. Burns E-mail: burns.lawrence@epa.gov _____________________________________________________________________________