                                                File:     READ.ME

                                QUAL2E
                 Enhanced Stream Water Quality Model
                             Version 3.22

                               QUAL2EU
    Enhanced Stream Water Quality Model with Uncertainty Analysis
                             Version 3.22

                                AQUAL2
     Interactive Data Preprocessor Program for QUAL2E and QUAL2EU
                             Version 1.23

                                Q2PLOT
  Interactive Graphics Postprocessor Program for QUAL2E and QUAL2EU
                             Version 1.23

                      U.S. EPA Release, May 1996


            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/546-3549



_________________________________________________________________

CONTENTS

     Introduction
     Abstract
     Documentation
     Distribution Diskettes
     File Name and Content
     Development System
     Routine Execution
     Run Time and Performance
     Minimum File Configuration
     Modification
     Technical Help Contact
     Disclaimer



_________________________________________________________________

INTRODUCTION

The Enhanced Stream Water Quality Model (QUAL2E) is a steady
state model for conventional pollutants in branching streams and
well mixed lakes.  It can be operated either as a steady-state or
dynamic model.  The model is intended for use as a water quality
planning tool.

The model can be used to study the impact of waste loads on
instream water quality.  It can also be used to identify the
magnitude and quality characteristics of non-point waste loads as
part of a field sampling program.  The user can

     o model effects of diurnal variations in meteorological data
       on water quality -- primarily dissolved oxygen and
       temperature
     o examine diurnal dissolved oxygen variation caused by algal
       growth and respiration

The Enhanced Stream Water Quality Model with Uncertainty Analysis
(QUAL2EU) is an enhancement to the QUAL2E model that allows the
user to perform uncertainty analysis.  Three uncertainty options
are available:

     o sensitivity analysis
     o first order error analysis
     o monte carlo simulation

With this capability, the user can assess the effect of model
sensitivities and uncertain input data on model forecasts.

AQUAL2 is an interactive data preprocessor program for the QUAL2E
and QUAL2EU models.  AQUAL2 can be used to build input data files
for either model.

Q2PLOT is an interactive data postprocessor program for the
QUAL2E and QUAL2EU models.  This program can read output from
either model (refer to FILE NAME AND CONTENT section) then
display text and/or two-dimensional graphs on the monitor screen
of the following information:

     o DO-BOD
     o nitrate and ammonia
     o SUM-N and organic N
     o dissolved P and organic P
     o CHLA and extinction coefficient
     o user specified curves

For a list of modifications since the last release of the QUAL2EU 
model system (version 3.21, February 1995), refer to the files
RELEASE.TXT and UPDATE.TXT (refer to FILE NAME AND CONTENT
section).

     NOTE:  For convenience, the terms "QUAL2EU model
     system" or "QUAL2EU" will be used in this document to
     refer to the QUAL2E model, QUAL2EU model, AQUAL2
     program, Q2PLOT program, and all associated support
     files and programs as a single unit.  Therefore, the
     term "QUAL2EU" is synonymous with "QUAL2EU model
     system" for purposes of this document.



_________________________________________________________________

ABSTRACT

Refer to file ABSTRACT.TXT for an abstract of the QUAL2EU model
system (refer to FILE NAME AND CONTENT section).



_________________________________________________________________

DOCUMENTATION

It is recommended that the user obtain and reference the
following document to operate and apply the QUAL2EU model system:

     The Enhanced Stream Water Quality Models QUAL2E and
     QUAL2E-UNCAS: Documentation and User Manual
     EPA/600/3-87/007, May 1987
     NTIS accession no.  PB87 202 156

This document can be ordered from the National Technical
Information Service (NTIS) at the address shown below.  When
ordering, use the NTIS accession number associated with the
document.  Contact NTIS for current price, and for shipping and
handling charges.

     National Technical Information Service (NTIS)
     5285 Port Royal Road
     Springfield, Virginia (VA)   22161
     703/487-4650

Copies of the following documents are included on the
distribution diskettes and within the electronic bulletin board
system (BBS)/Internet distribution file INSTALQ2.EXE.  Refer to
FILE NAME AND CONTENT and MINIMUM FILE CONFIGURATION sections for
further information.

Document Name(s)                               File Name(s)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     ~~~~~~~~~~~~
QUAL2EU model system general execution and         READ.ME
     user support guide
QUAL2EU Model System Release Notes              RELEASE.TXT
QUAL2EU Model System Update Notes                UPDATE.TXT
     (Enhancements/updates/additions not
     covered in current user manual)
QUAL2EU Model System Abstract                  ABSTRACT.TXT
ANNIE-IDE System Specification File            TERM_DAT.TXT
     (TERM.DAT) Quick Reference Guide

CEAM Software Product User Response Form       RESPONSE.TXT

     NOTE:  The files READ.ME, RELEASE.TXT, UPDATE.TXT,
     ABSTRACT.TXT, TERM_DAT.TXT and RESPONSE.TXT are ASCII
     text (non-binary) files that can be displayed on the
     monitor screen by using the DOS TYPE command (e.g.,
     TYPE READ.ME) or printed using the DOS PRINT command
     (e.g., PRINT READ.ME).

These documents should be retained by the requester for
reference.



_________________________________________________________________

DISTRIBUTION DISKETTES

     NOTE:  k=1,024; m=1,048,576; b=1 byte

Included are 2, 3.5 inch (1.44mb, DS/HD) DOS (Disk Operating
System) formatted diskettes containing the Enhanced Stream Water
Quality Model (QUAL2E, Version 3.22), Enhanced Stream Water
Quality Model with Uncertainty Analysis (QUAL2EU, Version 3.22),
Interactive Data Preprocessor Program for QUAL2E and QUAL2EU
(AQUAL2, Version 1.23), and Interactive Graphics Postprocessor
Program for QUAL2E and QUAL2EU (Q2PLOT, Version 1.23), U.S. EPA
release, dated May 1996.

This model system is designed for the IBM PC family of
microcomputer or compatible systems running under version 3.30 or
higher of the Microsoft or PC Disk Operating Systems (PC or MS
DOS -- refer to DEVELOPMENT SYSTEM section).  Properly configured,
this model system and its support files and programs can be
executed under PC DOS or MS DOS 3.30 and later versions, DOS
4.0x, DOS 5.0x, or DOS 6.x.

To install the QUAL2EU model system and/or related support files
and programs on a hard disk, insert the first distribution
diskette in a compatible diskette drive.  Type

                       A:\INSTALL or B:\INSTALL

at the DOS system prompt and press the <Enter> key.  Then follow
instructions and respond to the prompts presented on the monitor
screen by the interactive installation program.  This is a
compressed, self-extracting, interactive installation program
with on-line, context sensitive help that contains the QUAL2EU
model system (AQUAL2, QUAL2E, QUAL2EU, and Q2PLOT, Version 3.22),
dated May 1996.

     NOTE:  If the QUAL2EU model system is being installed
     from the QUAL2EU installation file (INSTALQ2.EXE)
     downloaded from the CEAM electronic bulletin board
     system (BBS) or the Internet, then the user should type

                               INSTALQ2

     at the DOS system prompt and press the <Enter> key. 
     This command assumes that the current default drive and
     sub-directory is the same drive and sub-directory that
     contain the file INSTALQ2.EXE.  For further information
     on the CEAM BBS and access to CEAM software products
     through the Internet, refer to the TECHNICAL HELP
     CONTACT section.

     NOTE:  The content of the distribution diskettes can be
     copied to another set of "backup" diskettes using the
     DOS DISKCOPY command.  Refer to the DOS Reference
     Manual for command application and use.  The "backup"
     diskettes must be the same size and storage density as
     the original source diskettes.

The following FILE NAME AND CONTENT section provides a brief
functional description of each file by name or file name
extension type.  Other sections in this document contain
information about

     o system development tools used to build the microcomputer
       release of the QUAL2EU model system
     o recommended hardware and software configuration for the
       execution of the model system and all support programs
     o program execution
     o minimum file configuration
     o program modification
     o technical support



_________________________________________________________________

FILE NAME AND CONTENT

Refer to file FILELIST.TXT for a complete list of all files -- with
the exception of the file FILELIST.TXT -- contained within the
distribution release of the QUAL2EU model system.  This file
contains a description of each file that can be decompressed from
the compressed distribution diskettes and/or file.



_________________________________________________________________

DEVELOPMENT SYSTEM

The following list describes the language and program development
tools used by the Center for Exposure Assessment Modeling to
build version 3.21 of the microcomputer implementation of the
QUAL2EU model system.

Also shown are the recommended minimum hardware and software
configuration and the recommended \CONFIG.SYS
configuration/environment file statements for the implementation
and execution of this model system and all related support files
and programs.  Make sure that the IBM PC or compatible system has
these statements in the \CONFIG.SYS file, and re-boot the system
to implement these changes before attempting to install or use
the QUAL2EU model system.

    Development System:

       Hardware System:     Fully IBM compatible 80386, 80486, or
                            80586
              Language:     FORTRAN 77
      Operating System:     DOS version 3.30 or higher.  Properly
                            configured, this model system should
                            also work on hardware platforms with
                            PC DOS or MS DOS versions 4.0x, 5.0x,
                            or 6.x
          DOS Extender:     Phar Lap 386/DOS-extender; bound into
                            application EXE files with automatic
                            virtual memory management;
                            distributed royalty free
        Memory Manager:     Compatible with VDISK.SYS, QEMM386,
                            HIMEM.SYS, RAMDRIVE.SYS, EMM386,
                            CEMM, 386Max; compatible with DPMI,
                            VCPI, and XMS standards

              Compiler:     Lahey FORTRAN, F77L-EM/32 version
                            5.01
           Link Editor:     Phar Lap 386LINK version 4.1L
        User Interface:     ANNIE-IDE  version 2.0x, 3.0x (beta)
                            INTERACTER version 1.40

     Overlay Structure:     None - linked as flat memory models
                            and programs

  Storage Requirements:     (k=1,024; m=1,048,576)

  Random Access Memory:     (approximate minimum free bytes
                            needed to execute EXE files)

                            640k base (low end) memory, plus
                            4.3m bytes of free extended (XMS)
                            memory and 7.0m bytes of free disk
                            space; or, 1m byte of free extended
                            (XMS) memory and 11.3m bytes disk
                            space

        Diskette Drive:     Required for installation only.
       Hard Disk Drive:     32m byte drive recommended (minimum)
                            with 10.0m bytes free (minimum)
     Installation Size:     Run Time:  Approx. 8m bytes max.

         Run time size:     Up to approximately 8.0m bytes plus
                            space for user input data files,
                            output, and temporary files produced
                            by model system (refer to MINIMUM
                            FILE CONFIGURATION section).

 Numerical Coprocessor:     Required.

\CONFIG.SYS Statements:     BREAK=ON
                            BUFFERS=20 or BUFFERS=32
                            FILES=20
                            DEVICE=C:\ANSI.SYS
                            DEVICE=extended memory manager

                                         - and -

                            SHELL=C:\COMMAND.COM C:\ /e:512 /p



_________________________________________________________________

ROUTINE EXECUTION

     NOTE:  The symbol "<Enter>" represents pressing the
     <Enter> or carriage return key.  Responses and key
     strokes that can be typed by the user are underlined
     with the hyphen character (-) and/or enclosed by the
     angle bracket characters (<>).

     NOTE:  It is possible that the QUAL2EU model system
     could be incompatible with MS DOS and Windows software
     cache files SMARTDRV.SYS or SMARTDRV.EXE loaded from
     the system configuration files \CONFIG.SYS and/or
     \AUTOEXEC.BAT on the boot drive.  If any portion of the
     QUAL2EU model system prematurely halts, produces
     unusual results, and/or causes the host system to halt
     or hang, remove any SMARTDRV statements on the boot
     drive \CONFIG.SYS and/or \AUTOEXEC.BAT files, then
     re-boot the system to implement these changes before
     attempting to reuse any portion the QUAL2EU model
     system.

Introduction
~~~~~~~~~~~~
Complete the installation process to make the full or any portion
of the QUAL2EU model system and related files resident on a hard
(usually designated as "C:") or virtual disk drive.  Then modify
the \CONFIG.SYS system environment file and restart the
microcomputer system.  This needs to be completed only once for a
given installation of the QUAL2EU model system.

DOS Storage Path
~~~~~~~~~~~~~~~~
Verify that the QUAL2EU model system executable task image files
(*.EXE), DOS batch command files (*.BAT), other run time support
files, and user defined input data file(s) are in the current
default DOS sub-directory.  It is convenient but not required to
have these files in the same sub-directory.

     NOTE:  To execute a DOS batch command file (*.BAT) --
     and hence a model or program spawned (i.e., executed)
     buy a given batch command file -- from any
     sub-directory located on a hard or virtual disk drive,
     add the QUAL2EU installation sub-directory (e.g.,
     C:\QUAL2EU) to the DOS search PATH and copy other
     appropriate run time support files to the current
     default sub-directory.  One way to accomplish this is
     to add or modify the PATH statement in the system
     start-up file, AUTOEXEC.BAT (located in the root
     directory on the start-up or boot drive).  For example

     PATH C:\;C:\DOS;C:\UTIL;C:\WP51;C:\QUAL2EU

     If any portion of the QUAL2EU model system prematurely
     halts, produces unusual results, and/or causes the host
     system to halt or hang, copy all DOS batch and other
     run time support files from the QUAL2EU model system
     installation sub-directory to the current default sub-
     directory from where the QUAL2EU model system is being
     executed via the DOS search PATH statement.

     Refer to the DOS Reference Manual for PATH command and
     AUTOEXEC.BAT file application and use.

Routine Execution Steps
~~~~~~~~~~~~~~~~~~~~~~~
Step Description/Action
~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1)   Set the default drive to the disk containing the QUAL2EU
     model system sub-directory.  For example:

     A:\> C:<Enter>
          --

2)   Change the DOS default sub-directory to the sub-directory
     designated by the user during the installation program as
     the installation sub-directory (e.g., QUAL2EU).  Use the DOS
     CD (change directory) command at the DOS system prompt:

     C:\> CD \QUAL2EU<Enter>
          -----------

     NOTE:  A common problem is for a DOS executable or
     batch command file (*.EXE, *.BAT) to be unable to
     locate a file because it assumes the file is on the
     default drive and/or sub-directory when it is not.  If
     input and/or other run time support file(s) are not on
     the default drive and sub-directory, the user can type
     a drive and/or path name ahead of the file name.  For
     further information refer to the "File Name and Path
     Specifications" sub-section later in this document or
     the DOS Reference Manual.

3)   To execute the AQUAL2 program, type:

     C:\QUAL2EU> AQUAL2<Enter>
                 ------

     Follow the menu and parameter options presented on the
     display screen.  Execution of this program is optional. 
     However, prior to their execution, the QUAL2E and QUAL2EU
     models require input data files that have been built either
     with the AQUAL2 program or manually using a word processor
     or text editor that can save a file in ASCII text (non-
     binary) format.

4)   To execute the QUAL2E model, type:

     C:\QUAL2EU> QUAL2E<Enter>
                 ------

     After opening banner/registration screens (2) are displayed
     on the monitor, press the <Enter> key to clear the screen,
     then select from and follow information screens and prompts
     displayed on the monitor screen.

     The model will begin prompting the user for information
     needed for this run of the model, or the model will read all
     or a portion of this information from the QUAL2E.SUP run
     time supervisor file and begin execution.  Refer to the FILE
     NAME AND CONTENT section for an explanation of the
     QUAL2E.SUP file.  If the QUAL2E.SUP file does not exist or
     does not contain all or any of the run time control
     information (refer to QUAL2E.SUP file for documentation),
     the model will prompt the user one line at a time for the
     information and data that is required to execute the model.

     NOTE:  The option LPT1 can be typed at the prompt that
     requests the user to select the name of the QUAL2E (or
     QUAL2EU) output file.  The selection of LPT1, instead
     of a file name, routes the output of a model directly
     to the printer (if available) instead of a file stored
     on a hard or virtual disk.

     NOTE:  Run time status messages that can be displayed
     on the monitor screen describe what portion of the
     model code is currently being executed.  A selection of
     no (N or n) improves overall run time speed by
     displaying fewer status messages than a response of yes
     (Y or y).  It is suggested that for routine execution a
     response of no (N or n) be used.  If an input data file
     is being executed for the first time, or if the user
     wishes to execute QUAL2E in a "debug" or test mode, it
     is suggested that a yes (Y or y) response be used.  For
     batch processing, it is suggested that a no (N or n)
     response be selected.  Refer to the documentation
     within the QUAL2E.SUP file for further information.

     NOTE:  A prompt asking the user for the name of the
     file containing local climatology data for dynamic
     (DIURNAL) simulation will only appear if the user
     enters the name of a dynamic simulation input data file
     (e.g., DIURNL.DAT) at the first prompt (i.e., for the
     input file name).

5)   To execute the QUAL2EU model, type:

     C:\QUAL2EU> QUAL2EU<Enter>
                 -------

     After opening banner/registration screens (2) are displayed
     on the monitor, press the <Enter> key to clear the screen,
     then select from and follow the information screens and
     prompts displayed on the monitor screen.

     The model will begin prompting the user for information
     needed for this run of the model, or the model will read all
     or a portion of this information from the QUAL2E.SUP run
     time supervisor file and begin execution.  Refer to the FILE
     NAME AND CONTENT section for an explanation of the
     QUAL2E.SUP file.  If the QUAL2E.SUP file does not exist or
     does not contain all or any of the run time control
     information (refer to QUAL2E.SUP file for documentation),
     the model will prompt the user one line at a time for the
     same information and data that is required to execute the
     QUAL2E model with the exception of the local climatology
     data for dynamic (DIURNAL) simulation.  There are additional
     prompts that are issued only by the QUAL2EU model.

6)   To execute the Q2PLOT program, type:

     C:\QUAL2EU> Q2PLOT<Enter>
                 ------

     Follow the menu and parameter options presented on the
     display screen.  Execution of this program is optional. 
     However, prior to its execution, this program requires a
     plot data file (refer to "Special Run Time Files" in the
     FILE NAME AND CONTENT section).  Plot data files can be
     created by executing either the QUAL2E or QUAL2EU model.

Viewing Output Results
~~~~~~~~~~~~~~~~~~~~~~
After executing a QUAL2EU model system executable task image
file, the user can view an output file, if any, produced by the
execution of a program or model if and only if that 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 and/or (2) named by the user at a run time
prompt.  A word processor or text editor is convenient for this
purpose, or the command

                         TYPE filename | MORE

can be used where "filename" is the name of the output file.

However, the TYPE command is awkward for files that exceed the
80-column screen width.  Alternatively, the output file can be
printed.  A compressed print mode (132 column) should be used to
avoid awkward -- wrapped around -- output from lines that exceed
80 columns.  The DOS MODE command can be used for this purpose. 
For a parallel printer assigned to LPT1, the DOS command

                            MODE LPT1: 132

will cause most printers to print in compressed mode.  For
further information, refer to the DOS Reference Manual.

File Name and Path Specifications
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A file name, path specification, and/or the parameter file name
argument "filename" must be a unique and valid DOS path and/or
file name.  The user response "filename" must also be a valid
QUAL2EU model system input or output file name -- either
furnished with the distribution package (refer to FILE NAME AND
CONTENT section) or created, designated, and named by the user. 
A file name used as input data for any program and/or model in
the QUAL2EU model system will be processed and executed in that
run of the program or model.

File names used for the input data and/or output listing files
(except for the test input and example output cases provided) are
arbitrary, but must follow the rules for DOS file names.  A file
name should assist the user with identifying the contents or
purpose of a file (e.g., INPUT.DAT, OUTPUT.LST).

In general, any DOS file name can be from 1 to 8 characters and
can have an optional 1 to 3 character file name extension.  Any
characters beyond 8 in the file name or beyond 3 in the file name
extension will be truncated and ignored by the DOS operating
system.  Refer to the DOS Reference Manual for further
information on file names and disk file input/output procedures,
rules, and commands.



_________________________________________________________________

RUN TIME AND PERFORMANCE

     NOTE:  The symbol "<Enter>" represents pressing the
     <Enter> or carriage return key.  Responses and key
     strokes that can be typed by the user are underlined
     with the hyphen character (-) and/or enclosed by the
     angle bracket characters (<>).

The following run times (approximate) were observed using the
test data files furnished with the distribution version of the
QUAL2EU model system.  Remember that these times were obtained
using test data files that may not be representative of a "real
world" problem and/or data.  The test data files have been
furnished for testing the installation of the QUAL2EU model
system and for instruction by example.

In general, these input test data files are not intended to be
representative of full scale model simulations.  They were
developed to test the installation of significant sections of
model code.

The run times listed in the table below were produced on a
Microway 80486 B2T EISA class microcomputer running under MS DOS
6.0 and using 640k bytes of random access (low end) memory (RAM),
32 megabytes of extended memory, a 32 megabyte virtual (RAM)
disk, Microp 1624-15 SCSI 765 megabyte DPT EISA hard disk with
512K byte cache SCSI controller, a 256K byte memory cache, a 66
megahertz clock, a Number Smasher-860 40 megahertz, 32 megabyte
math numerical coprocessor, and an ATI Ultra Graphics 1 megabyte
video card.


**  Test Data Files for QUAL2E Test Runs

                                         Climate Data               Approx.
   Input         Output        Detailed  File, and/or  Output Plot  Run Time
   File Name     File Name     Messages  Observed DO   File Name    hr:min:sec
   ~~~~~~~~~~~~  ~~~~~~~~~~~~  ~~~~~~~~  ~~~~~~~~~~~~  ~~~~~~~~~~~  ~~~~~~~~~~
a) WRKSHOP1.DAT  WRKSHOP1.LST     N      <Enter>       OSIM1.DPL    00:00:08
b) WRKSHOP2.DAT  WRKSHOP2.LST     N      <Enter>       OSIM2.DPL    00:00:08
c) WRKSHOP2.DAT  WRKSHP2X.LST     Y      WRKSPDO.DAT   OSIM2X.DPL   00:00:08
d) WRKSHOP3.DAT  WRKSHOP3.LST     Y      <Enter>       OSIM3.DPL    00:00:08
e) DIURNL.DAT    DIURNL.LST       N      DINTMP.DAT,   OSIMD.DPL    00:00:10
                                            <Enter>


**  Test Data Files for QUAL2EU Test Runs

                                         Climate Data
   Input         Output        Detailed  File, and/or  Output Plot
   File Name     File Name     Messages  Observed DO   File Name
   ~~~~~~~~~~~~  ~~~~~~~~~~~   ~~~~~~~~  ~~~~~~~~~~~~  ~~~~~~~~~~~
f) WTHBASE1.DAT  WTHUAF1.LST       N     <Enter>       OSIMW1.DPL
g) WTHBASE1.DAT  WTHUAM.LST        Y     WTHDO.DAT     OSIMW.DPL

                 UNCAS Input    UNCAS Input  Approx.
                 Specification  Variance     Run Time
                 File Name      File Name    hr:min:sec
                 ~~~~~~~~~~~~~  ~~~~~~~~~~~  ~~~~~~~~~~
f) continued     WTHUAF1.DAT    WTHINV.DAT   00:00:44
g) continued     WTHUAM.DAT     WTHINV.DAT   00:01:19

Program run time and performance can be affected by many
microcomputer system and program parameters including

     o available disk space
     o available memory
     o processor/CPU classification
     o CONFIG.SYS and AUTOEXEC.BAT file options and parameter
       values
     o disk and/or file storage and/or fragmentation



_________________________________________________________________

MINIMUM FILE CONFIGURATION

The following list describes the absolute minimum file
configuration needed within the application sub-directory to
execute and/or test the QUAL2EU model system and all support
command files and programs.

This list assumes that

     o the QUAL2EU model system and all support files and
       programs have been successfully installed from the
       distribution release
     o the user has defined and stored all application specific
       run time files

     NOTE:  Files other than those listed below can be
     deleted if the user needs to recover disk space.


**  Sub-directory InstallationDirectory\README:

READ.ME      - QUAL2EU model system execution and general support
               guide.
RELEASE.TXT  - Summary of corrections and/or changes between
               release versions.
UPDATE.TXT   - Summary of enhancements, updates, and additions
               not covered in the current user's manual.
ABSTRACT.TXT - QUAL2EU Model System Abstract.
TERM_DAT.TXT - ANNIE-IDE System Specification File (TERM.DAT)
               Quick Reference Guide.
RESPONSE.TXT - CEAM Software Product User Response Form.


**  Sub-directory InstallationDirectory:

F77L3.EER    - Run time error message library file for Lahey
               FORTRAN (F77L3).
RETURN1.ANS  - An empty file containing a single carriage return
               character used to provide an <Enter> key or null
               response to an input prompt in selected DOS batch
               command files.
MENU.BAT     - DOS batch command file used to display the QUAL2EU
               model system command menu on the monitor screen.
QUALMENU.TXT - ASCII text file containing the QUAL2EU model
               system command menu.
MESSAGE.WDM  - Screen definition file read automatically by the
               AQUAL2 and Q2PLOT programs.
TERM.DAT     - ANNIE-IDE system specification (terminal
               definition) file used by the AQUAL2 and Q2PLOT
               programs.
AQUAL2.BAT   - DOS batch command file used to execute the AQUAL2
               program.
CONFIG.FIL   - ASCII text file that stores the sub-directory
               location of the QUAL2E and QUAL2EU run time
               support files MSGFILE.DAT and UCODE.DAT.
MSGFILE.DAT  - ASCII text file containing run time status and
               error diagnostic messages that are read and
               displayed on the monitor screen during the
               execution of the QUAL2E and QUAL2EU models.
QUAL2E.SUP   - Run time supervisor file that can be used to
               answer interactive prompts issued during execution
               of the QUAL2E and/or QUAL2EU models.
QUAL2E.BAT   - DOS batch command file used to execute the QUAL2E
               model.
QUAL2EU.BAT  - DOS batch command file used to execute the QUAL2EU
               model.
Q2PLOT.BAT   - DOS batch command file used to execute the Q2PLOT
               program.
COMPUTER.SMB - INTERACTER computer related symbol set file that
               is read automatically by the Q2PLOT program.
INTERACT.INI - INTERACTER initialization data file that is read
               automatically by the Q2PLOT program.
SIMPLEXR.CHR - INTERACTER simplex Roman character set file that
               is read automatically by the Q2PLOT program.

     WARNING:  Executable task image files (*.EXE) should
     only be executed using the corresponding DOS batch
     command file provided (*.BAT).

XAQUAL2X.EXE - Executable task image file for the AQUAL2 program.
XQUAL2EX.EXE - Executable task image file for the QUAL2E model.
XQUAL2UX.EXE - Executable task image file for the QUAL2EU model.
XQ2PLOTX.EXE - Executable task image file for the Q2PLOT program.

ATUTOR.LOG   - Interactive tutorial session command (macro) file
               for the AQUAL2 program.
WRKSHOP1.DAT - Example input data files to test the installation
WRKSHOP2.DAT   and demonstrate application of the QUAL2E model.
WRKSHOP3.DAT
WRKSPDO.DAT
WRKDOPLT.DAT
DIURNL.DAT   - Example input data files to test the installation
DINTMP.DAT     and demonstrate application of the QUAL2E model
               using climatology data for dynamic (diurnal)
               simulation.
WTHINV.DAT   - The file WTHINV.DAT is an input variance
INVAR.DAT      uncertainty information file used with the
               uncertainty data files WTHUAF1.DAT and WTHUAM.DAT.
WTHBASE1.DAT - Example input data files to test the installation
WTHUAF1.DAT    and demonstrate application of the QUAL2EU model.
WTHUAM.DAT
WTHDO.DAT
UCODE.DAT    - Input data read automatically by the QUAL2EU
               model.
OSIM.DAT     - Test plot input specification files to test the
OSIMO.DAT      installation of the Q2PLOT program.
QWTHDO.DAT
QTEST.LOG    - Example interactive command (macro) input file to
               test the installation and demonstrate application
               of the Q2PLOT program.


**  Sub-directory InstallationDirectory\OUTPUT:

WRKSHOP1.OUT - Output listing files produced by the QUAL2E and
WRKSHOP2.OUT   QUAL2EU models using the test input data files
WRKSHOP3.OUT   that are provided with the distribution release.
WRKSHP2X.OUT
WTHUAF1.OUT
WTHUAM.OUT
DIURNL.OUT



_________________________________________________________________

MODIFICATION

Included with the distribution release are

     o executable task image files for the QUAL2EU model system
     o FORTRAN source code files for IBM PC and compatible
       microcomputer systems (refer to DEVELOPMENT SYSTEM
       section)

A FORTRAN compiler and link editor are NOT required to execute
any portion of the QUAL2EU model system.  If the user wishes to
modify any portion of the QUAL2EU model system, it will be up to
the user to supply and/or obtain

     o an appropriate text editor that saves files in ASCII text
       (non-binary) format
     o FORTRAN program development tools to recompile and link
       edit any model and/or program
     o ANNIE-IDE library system version 3.0x or later
     o INTERACTER version 1.40 or later

The U.S. EPA CEAM cannot support, maintain, and/or be responsible
for modifications that change the function of any executable task
image file (*.EXE) or DOS batch command file (*.BAT) supplied
with this model package.



_________________________________________________________________

TECHNICAL HELP CONTACT

     NOTE:  This section assumes that the user has
     successfully completed the installation process to make
     the full or any portion of the QUAL2EU model system and
     related files resident and fully operational on a hard
     (usually designated as "C:") or virtual disk drive. 
     For further information on installation and execution,
     refer to the DISTRIBUTION DISKETTES and ROUTINE
     EXECUTION sections.

For questions and/or information concerning

     o installation and/or testing of the QUAL2EU model system
       and/or support programs or files, call 706/546-3590 for
       assistance or send mail via Internet to
       ceam@epamail.epa.gov
     o model content, theory and/or application, call 706/546-
       3180 for assistance
     o use of the CEAM electronic bulletin board system (BBS) or
       the Internet, contact the BBS system operator (SYSOP) at
       706/546-3590
     o other environmental software products and documentation
       distributed through CEAM, contact the Model Distribution
       Coordinator at 706/546-3549
     o other support available through CEAM, contact Mr. Frank
       Stancil, CEAM Manager

       - by mail at the following address

         Center for Exposure Assessment Modeling (CEAM)
         National Exposure Research Laboratory -
              Ecosystems Research Division
         U.S. Environmental Protection Agency
         960 College Station Road
         Athens, Georgia  30605-2700

       - by telephone at 706/546-3130
       - by fax at 706/546-3340
       - by email or Internet at stancil.frank@epamail.epa.gov
       - through the CEAM BBS message menu and commands.  The
         CEAM BBS communication parameters and telephone number
         are listed below.

To help technical staff provide better assistance, write down a
response to the following topics before calling or writing.  If
calling, be at the computer, with the computer on, and in the
proper sub-directory (e.g., C:\QUAL2EU) when the call is placed.

     o program information:

       - describe the problem, including the exact wording of any
         error and/or warning message(s)
       - list the exact steps, command(s), and/or keyboard key
         sequence that will reproduce the problem

     o machine information:

       - list computer brand and model
       - list available RAM (as reported by DOS CHKDSK or MEM
         command)
       - list extended memory present and free (XMS)
       - list name and version of extended memory (XMS) manager
         (i.e., HIMEM, VDISK, RAMDRIVE, etc.)
       - list available hard disk space (as reported by DOS
         CHKDSK command)
       - list the brand and version of DOS (as reported by DOS
         VER command)
       - list the name of any memory resident (TSR) program(s)
         installed
       - printer brand and model
       - monitor brand and model

     NOTE:  If contacting CEAM by mail, fax, or BBS, include
     responses to the above information in correspondence.

To check the status of the latest release of this model system or
any other CEAM software product, the user can

     o call the CEAM BBS 24 hours a day, 7 days a week, or
     o subscribe to the CEAM listserver mailing list system.

To access the BBS, a computer with a modem and communication
software are needed.  The phone number for the BBS is
706/546-3402.  Communication parameters for the BBS are

     o 1200-14400 baud
     o 8 data bits
     o no parity
     o 1 stop bit

CEAM operates a UNIX Listserver mailing list system.  The name of
the list is CEAM-USERS.  Listserver is an automated mailing list
system.  A user can add him/her-self to a selected mailing list,
post messages, and/or review/read messages.  Lists can be
moderated (owner decides which messages are made public) or un-
moderated (all incoming messages are posted).  Listserver is best
suited for e-mail discussion groups.  It is not a file service
such as for the distribution of CEAM software products.

This listserver broadcasts up-to-date information concerning CEAM
software products, activities, and events.  This includes
announcements for CEAM and/or non-CEAM supported workshops and
training sessions; software product version release, updates, and
documentation information; hints on software installation,
operation, application, problems, and/or enhancements; and the
exchange of information quickly among users, and between users
and CEAM support personnel.

     NOTE:  The CEAM-USERS list is not moderated.

For example, to subscribe execute a mail service to send the
following information:

     NOTE:  The symbol "<Enter>" represents pressing the
     <Enter> or carriage return key.  Responses and key
     strokes that can be typed by the user are underlined
     with the hyphen character (-) and/or enclosed by the
     angle bracket characters (<>).

mail listserver@unixmail.rtpnc.epa.gov<Enter>
--------------------------------------
Subject:<Enter>
subscribe CEAM-USERS yourfirstname yourlastname<Enter>
-----------------------------------------------
<Ctrl><D>
---------

The user can also check the status of this model system or any
other CEAM software product through Internet node

                             ftp.epa.gov

The QUAL2EU model system and selected other CEAM software
products for microcomputer (i.e., DOS, NOT UNIX) installation and
application can be down loaded through Internet from the above
node via "anonymous" ftp (File Transfer Protocol) log in and file
transfer commands and options.  For further information on this
Internet node and ftp, refer to document files USERINFO.TXT,
QREF_WWW.TXT, QUICKREF.TXT, LISTSERV.TXT that are included in the
file INTERNET.ZIP that can be down loaded from the Internet or
the CEAM BBS through the file INTERNET.ZIP.

To access DOS releases of selected CEAM software products via
Internet, start the ftp program from the user's Internet node
system (type 'ftp'), establish ftp connection (type 'open
ftp.epa.gov'), log on using anonymous account (type 'anonymous'). 
Respond to password prompt with users e-mail or Internet address. 
Then, upon log in completion, type 'cd epa_ceam', read CEAM
Internet Welcome Screen, then type 'get CEAMNEWS.TXT -' to view
latest news and list of CEAM software products available on the
Internet.

The same selected CEAM software products as mentioned above are
also available through the World Wide Web (WWW).  If the user has
access to the World Wide Web and WWW browser software (e.g.,
Netscape, Mosaic), selected CEAM software products, including the
QUAL2EU model system, can be accessed at the following Uniform
Resource Locator (URL):

           ftp://ftp.epa.gov/epa_ceam/wwwhtml/ceamhome.htm



_________________________________________________________________

DISCLAIMER

Mention of trade names or use of commercial products does not
constitute endorsement or recommendation for use by the United
States Environmental Protection Agency.

Execution of any portion of the QUAL2EU model system, and
modification to the DOS system configuration files (i.e.,
\CONFIG.SYS and \AUTOEXEC.BAT) must be used and/or made at the
user's own risk.  Neither the U.S. EPA nor the program author(s)
can assume responsibility for model and/or program modification,
content, output, interpretation, or usage.

The QUAL2EU program and files have been extensively tested and
verified.  However, as for all complex software products, the
programs herein may not be completely free of errors and may not
be applicable for all cases.  In no event will the U.S. EPA be
liable for direct, indirect, special, incidental, or
consequential damages arising out of the use of the programs
and/or associated documentation.

CEAM software products are built using FORTRAN-77, assembler,
other third and forth generation symbolic reference languages,
and operating system interface command languages.  The code
structure and logic of these products is designed for
single-user, single-tasking, non-LAN environment and operating
platform for microcomputer installations (i.e., single user on
dedicated system).

A user will be on their own if he/she attempts to install a CEAM
product on a multi-user, multi-tasking, and/or LAN based system
(i.e., Windows, DESQview, any LAN).  CEAM cannot provide
installation, operation, and/or general user support under any
combination of these configurations.  Instructions and conditions
for proper installation and testing are provided with the product
in a READ.ME file.  While multiuser/multitasking/LAN
installations could work, none of the CEAM products have been
thoroughly tested under all possible conditions.  CEAM can
provide selected and/or limited scientific and/or application
support for selected products if the user proves that a given
product is installed and working correctly.

     o WordPerfect is a registered trademark of WordPerfect
       Corporation
     o Microway and Number Smasher are registered trademarks of
       Microway, Inc.
     o Intel, 386, 486, and 860 are registered trademarks of
       Intel Corporation.
     o F77L is a registered trademark of Lahey Computer Systems,
       Inc.  All other Lahey products are trademarks of Lahey
       Computer Systems, Inc.
     o IBM, Personal Computer/XT (PC/XT), Personal Computer/AT
       (PC/AT), PC DOS, VDISK, and Personal System/2 (PS/2) are
       registered trademarks of International Business Machines
       Corporation
     o PKZIP, PKUNZIP, and PKSFX are registered trademarks and/or
       trademarks of PKWARE, Incorporated.
     o DESQview is a trademark of Quarterdeck Office Systems,
       Inc.
     o Sun and SunOS are registered trademarks of Sun
       Microsystems, Inc.
     o SPARC is a registered trademark of SPARC International,
       Inc.
     o UNIX is a registered trademark of American Telephone and
       Telegraph
     o SVS FORTRAN-77 is a trademark of Silicon Valley Software
     o PRIME and PRIMOS are trademarks of Prime Computers, Inc.
     o Microsoft, RAMDRIVE, HIMEM, MS, and MS-DOS are
       registered trademarks of Microsoft Corporation
     o Windows is a trademark of Microsoft Corporation
     o RM/FORTRAN is a trademark of Language Processors, Inc.
     o DEC, VAX, VMS, and DCL are trademarks of Digital Equipment
       Corporation
     o US Robotics is a registered trademark and Courier HST is a
       trademark of U.S. Robotics, Inc.
     o VP-Expert is a registered trade mark of WordTech Systems,
       Inc.


                    #########################

DWD/dwd - May 1996 - E:\QUAL2EU\README\READ.ME

