                                                           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:<Enter>
          --

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<Enter>
          ---------

3)   Execute the EXAMS model:

     C:\EXAMS> EXAMS<Enter>
               -----
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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<Enter>
        -------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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<Enter>
          ----------------------------------

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:<Enter>
          --

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<Enter>
          ---------

3)   To execute the EXAMS model, type:

     C:\EXAMS> EXAMS<Enter>
               -----

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

_____________________________________________________________________________
