                                                    File: READ.ME

                              WASP
    Water Quality Analysis Simulation Program Modeling System
                          Version 5.10

                         September 1993


         Center for Exposure Assessment Modeling (CEAM)
              U.S. Environmental Protection Agency
               Office of Research and Development
                Environmental Research Laboratory
                    960 College Station Road
                   Athens, Georgia  30605-2720

                          706/546-3549



_________________________________________________________________

CONTENTS

     Introduction
     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 WASP modeling system is a generalized modeling framework for
contaminant fate and transport in surface waters.  Based on
flexible compartment modeling, WASP can be applied in one, two,
or three dimensions.  WASP is designed to permit easy
substitution of user written routines into the program structure. 
Problems that have been studied using WASP include biochemical
oxygen demand, dissolved oxygen dynamics,
nutrients/eutrophication, bacterial contamination, and toxic
chemical movement.

The Toxic Chemical Model (TOXI) combines a kinetic structure
adapted from the Exposure Analysis Modeling System (EXAMS) with
the WASP transport structure and simple sediment balance
algorithms.  TOXI predicts dissolved and sorbed chemical
concentrations in the bed and overlying waters.

The Eutrophication Model (EUTRO) combines a kinetic structure
adapted from the Potomac Eutrophication Model with the WASP
transport structure.  This model predicts dissolved oxygen,
carbonaceous biochemical oxygen demand, phytoplankton, carbon,
chlorophyll-a, ammonia, nitrate, organic nitrogen, and
orthophosphate in bed and overlying waters.

The Hydrodynamic Program (DYNHYD) is a simple link-node
hydrodynamic program capable of simulating variable tidal cycles,
wind, and unsteady flows.  It produces an output file that
supplies flows, volumes, velocities, and depths (time averaged)
for the WASP modeling system.

     NOTE:  For convenience, the term "WASP model system"
     will be used in this document to refer to the TOXI
     model, the EUTRO model, the DYNHYD program, and all
     associated support files and programs as a single unit. 
     The term "WASP model" is synonymous with "WASP model
     system" for purposes of this document.



_________________________________________________________________

DOCUMENTATION

Copies of the following documents are included on the
distribution diskette set.  Refer to FILE NAME AND CONTENT and
MINIMUM FILE CONFIGURATION sections for further information.

Document Name                                    File Name(s)
~~~~~~~~~~~~~                                    ~~~~~~~~~~~~
WASP model system general execution and              READ.ME
     user support guide
WASP Model System Release Notes                   RELEASE.TXT
WASP Model System Update Notes                     UPDATE.TXT
     (Enhancements/updates/additions not
     covered in user's manual)
WASP Model System User's Manual, Part A          USERMANA.DOC
WASP Model System User's Manual, Part B          USERMANB.DOC
DYNHYD5 Program User's Manual                     DYNHYD5.DOC
ANNIE-IDE System Specification File              TERM_DAT.TXT
     (TERM.DAT) Quick Reference Guide
CEAM Software Product User Response Form         RESPONSE.TXT

These documents are applicable to the microcomputer installation
and application of the U.S. EPA release of the WASP model system. 
These documents should be retained by the requester for future
reference.

The files READ.ME, RELEASE.TXT, UPDATE.TXT, RESPONSE.TXT, and
TERM_DAT.TXT are ASCII (non-binary) text 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).  File names with a file name extension of
".DOC" are WordPerfect (binary) document files that can only be
viewed and/or printed within WordPerfect.



_________________________________________________________________

DISTRIBUTION DISKETTES

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

Included are 3, 3.5 inch (1.44mb, DS/HD) DOS (Disk Operating
System) formatted diskettes containing version 5.10 (September
1993) of the Water Quality Analysis Simulation Program (WASP)
modeling system.

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 WASP 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.

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

                           INSTALWP

     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 INSTALWP.EXE.  For further information
     on the CEAM BBS, refer to the TECHNICAL HELP CONTACT
     section.

     NOTE:  The contents 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 WASP 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 sample run times
     o program modification
     o technical support



_________________________________________________________________

FILE NAME AND CONTENT

The self-extracting, interactive executable program file on the
distribution diskettes exist in a compressed format to save
diskette space and file transfer time.  This section contains a
description of each file that can be decompressed from the
compressed distribution file.

Follow the instructions on the diskette label to install,
decompress (extract), and restore file(s) to their original name
and size in order to place the WASP model system in a usable
format on a hard or virtual disk.  For comparison purposes, the
original date and time of creation are also restored with each
file.

     NOTE:  Execution of the INSTALL or INSTALWP command can
     extract one or more WASP model system files.  These
     files are automatically stored into DOS sub-directories
     on the hard disk.  The sub-directory structure, under
     which the sub-directories shown below are stored, is
     selected by the user during execution of the INSTALL or
     INSTALWP program.  The string "InstallationDirectory"
     will be used to denote the highest level default
     installation directory structure chosen by the user
     during execution of INSTALL or INSTALWP.  The files are
     listed by DOS sub-directory name.


**  Sub-directory InstallationDirectory\DOCUMENT:

READ.ME      - WASP model system execution and general support
               guide.  This is an ASCII text file that can be
               displayed on the monitor screen with the DOS TYPE
               command or printed using the DOS PRINT command.

RELEASE.TXT  - Summary of corrections and/or changes between
               release versions.  This is an ASCII text file that
               can be displayed on the monitor screen with the
               DOS TYPE command or printed using the DOS PRINT
               command.

UPDATE.TXT   - Summary of enhancements, updates, and additions
               not covered in user's manual (USERMANA.DOC,
               USERMANB.DOC).  This is an ASCII text file that
               can be displayed on the monitor screen with the
               DOS TYPE command or printed using the DOS PRINT
               command.

RESPONSE.TXT - CEAM Software Product User Response Form.  This is
               an ASCII text file that can be displayed on the
               monitor screen with the DOS TYPE command or
               printed using the DOS PRINT command.

TERM_DAT.TXT - ANNIE-IDE System Specification File (TERM.DAT)
               Quick Reference Guide.

USERMANA.DOC - WASP modeling system user's manual, part A.  This
               file is a WordPerfect (binary) document that can
               only be viewed and/or printed within WordPerfect.

USERMANB.DOC - WASP modeling system user's manual, part B.  This
               file is a WordPerfect (binary) document that can
               only be viewed and/or printed within WordPerfect.

DYNHYD5.DOC  - DYNHYD5 modeling system user's manual.  This file
               is a WordPerfect (binary) document that can only
               be viewed and/or printed within WordPerfect.


**  Sub-directory InstallationDirectory:

WISP.EXE     - Executable task image file for the WASP
               Interactive Support Program (WISP).  It provides
               the user with an interactive shell for executing
               the TOXI and EUTRO WASP models, the DYNHYD
               program, and all associated run time support
               programs.

WISP.HLP     - WISP program run time support files that are read
WISP.OPL       automatically by the WISP executable task image
WISP.OVR       file (WISP.EXE).

PKZ204G.EXE  - A self-extracting executable program containing
               the executable files and documentation for the
               PKZIP and PKUNZIP (copyright 1989-1993 by PKWARE,
               Inc.) compression programs.  This file can be
               used, copied, and distributed for NONCOMMERCIAL
               use if

               o no fee is charged for use, copying, or
                 distribution
               o it is not modified in any way

     NOTE:  The execution of the PKZ204G.EXE program is not
     required in order for the user to be able to use any
     portion of the WASP model system.

PKZIP.EXE    - Executable task image file for the PKWARE file
               compression program as called by the WISP program.

PKUNZIP.EXE  - Executable task image file for the PKWARE file
               uncompression program as called by the WISP
               program.

     NOTE:  If the user finds these compression programs
     fast, easy, and convenient to use, register the copy
     with:

     PKWARE, Inc.
     9025 North Deerwood Drive
     Brown Deer, WI  53223-2437
     414/354-8699 (voice)
     414/354-8559 (FAX)
     414/354-8670 (BBS)

     Consult the file ORDER.DOC within the file PKZ204G.EXE
     for more information or write or call PKWARE, Inc.

F77L3.EER    - Run time error message library file for Lahey
               FORTRAN (F77L3) (refer to DEVELOPMENT SYSTEM
               section).  This file is read automatically by the
               WASP TOXI and EUTRO model and the DYNHYD program
               executable task image files (TOXI5.EXE,
               EUTRO5.EXE, DYNHYD5.EXE) if an error is detected
               during execution.

MESSFILE.DAT - WASP run time status message files read
DYNMES.DAT     automatically by the TOXI, EUTRO, and/or DYNHYD
WASP.ERF       model and program executable task image files
               (TOXI5.EXE, EUTRO5.EXE, DYNHYD5.EXE).

W5DSPLY.TXT  - WASP display program run time status message and
W5DSPLY.HLP    help files read automatically by the W5DSPLY
               program executable task image file (W5DSPLY.EXE).

TOXI5.EXE    - Executable task image file for the toxic chemical
               model.  To execute, type TOXI5 at the DOS system
               prompt then press the <Enter> key, or execute the
               WISP interactive shell program.

EUTRO5.EXE   - Executable task image file for the eutrophication
               model.  To execute, type EUTRO5 at the DOS system
               prompt then press the <Enter> key, or execute the
               WISP interactive shell program.

AIDEDYN.BAT  - DOS batch command file used to execute the DYNHYD 
               model preprocessor program from the DOS command
               line or system prompt (refer to ROUTINE EXECUTION
               section).  To execute, type AIDEDYN at the DOS
               system prompt, press the <Enter> key, then respond
               to the prompts displayed on the monitor screen.

TERM.DAT     - ANNIE-IDE system specification (terminal 
               definition) file read automatically by the PREDYN
               program.  The ANNIE-IDE library files used to
               build the PREDYN program contains parameters that
               can be system dependent.  These parameters have a
               default value for a given system.  The defaults
               are in the primary message file, MESSAGE.WDM. 
               However, default values can be overridden by the
               user by using a TERM.DAT file in the sub-directory
               where the PREDYN program is stored.  Refer to the
               file TERM_DAT.TXT for further information on the
               modification and/or use of the TERM.DAT file.

PREDYN.EXE   - Executable task image file for the DYNHYD model
               preprocessor program.  This interactive program
               assists the user with the development of input
               data files for the DYNHYD model.  To execute, type
               AIDEDYN at the DOS system prompt, press the
               <Enter> key, then select from and follow the
               menus, options, and data entry field prompts
               displayed on the monitor screen.  This program can
               also be executed from the WISP interactive shell
               program.

                    WARNING:  This task image file
                    (PREDYN.EXE) should only be executed
                    using the DOS batch command file
                    provided if executed outside WISP
                    (AIDEDYN.BAT).

PREDYN.HLP   - Run time help message files read automatically by
KEYWORDS.DAT   the PREDYN program.

MESSAGE.WDM  - Screen definition file read by the PREDYN program 
               and used to produce and display on the monitor
               screen the text, application program menus, and
               data entry screens.  This is an unformatted,
               direct access file with a logical record length of
               2,048 bytes.

DYNHYD5.EXE  - Executable task image file for the DYNHYD program.
               To execute, type DYNHYD5 at the DOS system prompt
               then press the <Enter> key, or execute the WISP
               interactive shell program.

EDITOR.EXE   - Executable task image file for the EDITOR program.
               To execute, type EDITOR at the DOS system prompt
               then press the <Enter> key, or execute the WISP
               interactive shell program.  This editor program
               can be used to view or edit ASCII text (non-
               binary) files such as input read or output
               produced by model execution.

W5DSPLY.EXE  - Executable task image file for the W5DSPLY tabular
               post processor program for the TOXI, EUTRO, and
               DYNHYD models and program.  To execute, type
               W5DSPLY at the DOS system prompt then press the
               <Enter> key, or execute the WISP interactive shell
               program.

PLOT.EXE     - Executable task image file for the PLOT graphical
               post processor program for the TOXI, EUTRO, and
               DYNHYD models and program.  To execute, type
               W5DSPLY at the DOS system prompt then press the
               <Enter> key, or execute the WISP interactive shell
               program.

POND1.INP    - Sample input data files to test the installation
POND3SEQ.INP   and demonstrate application of the TOXI model.
SEDPOND.INP    These files have also been furnished to provide
SETPOND3.INP   instruction by example.  To test installation,
TOXRIV1.INP    execute the TOXI model then select these files
TOXRIV2.INP    individually as input data.  These are ASCII (non-
               binary) text files that can be displayed on the
               monitor screen with the DOS TYPE command or
               printed using the DOS PRINT command.  These files
               can also be viewed or edited using any editor
               program that can read and save a file to disk in
               ASCII text format.

LAKE.INP     - Sample input data files to test the installation
RIVER.INP      and demonstrate application of the EUTRO model.
T-LAKE.INP     These files have also been furnished to provide
               instruction by example.  To test installation,
               execute the EUTRO model then select these files
               individually as input data.  These are ASCII (non-
               binary) text files that can be displayed on the
               monitor screen with the DOS TYPE command or
               printed using the DOS PRINT command.  These files
               can also be viewed or edited using any editor
               program that can read and save a file to disk in
               ASCII text format.

DYNRIV.INP   - Sample input data files to test the installation
RIVERQ.INP     and demonstrate application of the DYNHYD program.
CANAL_H.INP    This file has also been furnished to provide
               instruction by example.  To test installation,
               execute the DYNHYD program then select these files
               individually as input data.  These are ASCII (non-
               binary) text files that can be displayed on the
               monitor screen with the DOS TYPE command or
               printed using the DOS PRINT command.  These files
               can also be viewed or edited using any editor
               program that can read and save a file to disk in
               ASCII text format.

     NOTE:  A file name path specification and/or file name,
     as typed by the user, must be a unique and valid DOS
     path and/or file name.  An input file name must also be
     a valid WASP model system input data 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
     with a WASP model system model or program will be
     processed and executed in the run of that model or
     program.  Remember, a DOS file name can be from 1 to 8
     characters and can have an optional 1 to 3 character
     file name extension.

*.BGI        - INTERACTER font, character, device, and display
*.CHR          driver and interface files read automatically by
*.INI          plot and display executable task image files.
*.PS

CLFLTOXI.BAT - DOS batch command file that can be used to
               compile and link edit the TOXI model FORTRAN
               source code files (*.CMN, *.INC, *.EQU, *.FOR) to
               incorporate changes made in the source code files
               by the user.  Refer to the program listing for in-
               code documentation.  The execution of this command
               produces a new executable task image file
               (TOXI5.EXE) for the TOXI model.  This command file
               only needs to be executed if changes have been
               made in the FORTRAN source code, not input data
               files.  To execute, type CLFLTOXI at the DOS
               system prompt, then press the <Enter> key.

CLFLEUTR.BAT - DOS batch command file that can be used to compile
               and link edit the EUTRO model FORTRAN source code
               files (*.CMN, *.INC, *.FOR) to incorporate changes
               made in the source code files by the user.  Refer
               to the program listing for in-code documentation. 
               The execution of this command produces a new
               executable task image file (EUTRO5.EXE) for the
               EUTRO model.  This command file only needs to be
               executed if changes have been made in the FORTRAN
               source code, not input data files.  To execute,
               type CLFLEUTR at the DOS system prompt, then press
               the <Enter> key.

CLFLDYNH.BAT - DOS batch command file that can be used to compile
               and link edit the DYNHYD program FORTRAN source
               code files (*.CMN, *.FOR) to incorporate changes
               made in the source code files by the user.  Refer
               to the program listing for in-code documentation. 
               The execution of this command produces a new
               executable task image file (DYNHYD5.EXE) for the
               DYNHYD program.  This command file only needs to
               be executed if changes have been made in the
               FORTRAN source code, not input data files.  To
               execute, type CLFLDYNH at the DOS system prompt,
               then press the <Enter> key.

ANSWER.COM   - Executable code file used by the CLFLTOXI.BAT,
               CLFLEUTR.BAT, and CLFLDYNH.BAT DOS batch command
               files to write a screen prompt and read the user
               response entered from the keyboard.  Do NOT
               attempt to type or print this file using the DOS
               TYPE or PRINT command.

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 the CLFLTOXI.BAT,
               CLFLEUTR.BAT, and CLFLDYNH.BAT DOS batch command
               files.

RETURNY.ANS  - A file containing a "Y" followed by a carriage
               return character used to provide a "Y" or "yes"
               response to an input prompt in the CLFLTOXI.BAT,
               CLFLEUTR.BAT DOS, and CLFLDYNH.BAT batch command
               files.

*.LNK        - Lahey FORTRAN 386LINK link edit command files (3)
               called and executed automatically by the compile
               and link edit DOS batch command files
               CLFLTOXI.BAT, CLFLEUTR.BAT, and CLFLDYNH.BAT.


**  Sub-directory InstallationDirectory\WASP:

*.CMN        - FORTRAN source code "include" files containing
CONST.INC      FORTRAN COMMON block declarations for the WASP
               model transport system.  These files are
               automatically included or "copied" into the
               appropriate FORTRAN source code file (*.FOR)
               during compilation.

*.FOR        - The FORTRAN source code files for the WASP model
               transport system, version 5.10.


**  Sub-directory InstallationDirectory\TOXI:

*.CMN        - FORTRAN source code "include" files containing
*.EQU          FORTRAN COMMON block and EQUIVALENCE declarations
CONST.INC      for the WASP model system toxic chemical model.
               These files are automatically included or "copied"
               into the appropriate FORTRAN source code file
               (*.FOR) during compilation.

*.FOR        - The FORTRAN source code files for the WASP model
               system toxic chemical model, version 5.10.


**  Sub-directory InstallationDirectory\EUTRO:

*.CMN        - FORTRAN source code "include" files containing
CONST.INC      FORTRAN COMMON block declarations for the WASP
               model system eutrophication model.  These files
               are automatically included or "copied" into the
               appropriate FORTRAN source code file (*.FOR)
               during compilation.

*.FOR        - The FORTRAN source code files for the WASP model
               system eutrophication model, version 5.10.


**  Sub-directory InstallationDirectory\DYNHYD:

DYNHYD.CMN   - FORTRAN source code "include" file containing
               FORTRAN COMMON block declarations for the WASP
               model system DYNHYD program.  This file is
               automatically included or "copied" into the
               appropriate FORTRAN source code file (*.FOR)
               during compilation.

*.FOR        - The FORTRAN source code files for the WASP model
               system DYNHYD program, version 5.11.



_________________________________________________________________

DEVELOPMENT SYSTEM

The following list describes the language and program development
tools used by the Center for Exposure Assessment Modeling to
build version 5.10 of the microcomputer implementation of the
WASP model system TOXI, EUTRO, and DYNHYD models.

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 these models and programs 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 WASP model system.

    Development System: (TOXI, EUTRO, and DYNHYD only)

       Hardware System:     Fully IBM compatible 80386 or 80486
              Language:     FORTRAN 77
        User Interface:     INTERACTER, version 2.0m
      Operating System:     DOS version 3.30 or higher.  Properly
                            configured, the WASP model system
                            should also work on systems 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

     Overlay Structure:     None - linked as flat memory models

  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, and
                            4mb of free extended (XMS) memory or
                            disk space

        Diskette Drive:     Required for installation only.
       Hard Disk Drive:     20m byte drive recommended (minimum)
                            with 6mb free (minimum)
     Installation Size:     Run Time:  Approx. 4.50m bytes max.
                            FOR Code:  Approx. 1.50m bytes max.
                                               _____

                                        Total  6.00m bytes

                            (Total does not include *.OBJ and if
                            all source code files are compiled
                            and linked.)

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

 Numerical Coprocessor:     Required.

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

                                         - and -

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

               Printer:     For *.DOC file only, HP LaserJet II
                            or compatible printer

      Printer Software:     For *.DOC file only, WordPerfect 5.1
                            or greater

     NOTE:  Approximate minimum free bytes of Random Access
     Memory needed to execute other EXE files are: 
     PREDYN.EXE - 480k, W5DSPLY.EXE - 452k, WISP.EXE - 308k,
     and PLOT.EXE - 480k.



_________________________________________________________________

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.

Complete the installation process to make the full or any portion
of the WASP 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 WASP model system.

1)   Set the default drive to the disk containing the WASP model 
     system sub-directory:

     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., WASP5).  Use the DOS
     CD (change directory) command at the DOS system prompt:

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

3)   To execute the WISP program, type:

     C:\WASP5> WISP <Enter>
               ----

WISP is an interactive, menu driven user environment that
allows ease of execution for all programs and models
associated with the WASP model system.  WISP allows the user
to view and/or edit TOXI, EUTRO, or DYNHYD model and program
input data files and to execute post processor programs on
results produced from model and/or program execution.

     NOTE:  To execute WISP and thus the WASP model
     system from any sub-directory located on a hard or
     virtual disk drive, add the WASP installation sub-
     directory (e.g., C:\WASP5) to the DOS search PATH. 
     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:\WASP5

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

Although on-line help is available, several options are
available from the main menu in the WISP program that should
be mentioned.

File Option and Menu
~~~~~~~~~~~~~~~~~~~~
o If help is needed in the WISP program, press the <F1> key.
  Based on the current cursor or mouse position, context
  sensitive help information will be presented on the
  monitor screen.
o WISP supports Microsoft mouse standards.  Therefore, the
  user can select and execute WISP options and programs by
  pointing and clicking with a mouse device.
o The user can select one or more WASP model system input or
  output files.  If the user selects an input file, the WISP
  program will automatically determine the type of file
  (i.e., TOXI, EUTRO, DYNHYD) then display selected
  information about the file in a file dialogue box located
  near the center of the display screen.
o If an input file has been selected, WISP will determine
  if any of the simulation result files (e.g., *.TRN, *.DF,
  *.MSB) exist.  If the file(s) exist, an option denoting
  those file(s) will be highlighted in the file dialogue
  box.
o The user can switch the active file at anytime.  For
  example, if the user wants to activate the transport file
  after previously selecting the input file, press <ALT><S>
  then use the mouse, space bar, or tab key from within the
  dialogue box file name extension list to select a new
  active file.
o The user can tag files for deletion.  This is an easy
  way to "clean-up" or remove files after successive
  simulation runs.  WISP will not allow the user to delete
  programs that are required for the execution of the WASP
  model system.  To use the delete option, tag the file(s)
  to delete by pressing the space bar or left mouse button. 
  Then use the arrow keys to move around the pick list. 
  Once the file(s) have been selected, the user is prompted
  to press the <Enter> key.  The user will then be asked to
  delete the files with or without confirmation.  If the
  user selects confirmation, WISP displays a yes/no prompt
  for each individual file to be deleted.

     NOTE:  The response entered by the user for any
     file name must be a unique and valid DOS file
     name.  A WASP model system input file name must
     be a valid file name either 1) as furnished with
     the distribution package (refer to FILE NAME AND
     CONTENT section) or 2) as designated and/or
     generated by user selected text editing
     software.  This data file will be processed
     during the execution of a model.  The default
     file name extension for a WASP model system
     input file is INP (e.g., MYDATA.INP).

     File names used for the input data and/or output
     listing files (except for the test input and
     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).

     Any 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 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.

Browse Option and Menu
~~~~~~~~~~~~~~~~~~~~~~
This option and menu allows the user to view and/or edit a
file selected by the user.  This is very useful in viewing
input/output data files.  The browse option and menu can be
operated with a mouse.

Editor Option and Menu
~~~~~~~~~~~~~~~~~~~~~~
The WISP editor can be used to build WASP input data files. 
It can create, edit, and save ASCII (non-binary) text files. 
This is a full screen editor with mouse support.  For
specific information on valid editor commands and options,
refer to the on-line help.

To edit an active file (refer to File Option and Menu
section), press E.  WISP will pass the active file into the
editor.  If a file has not been previously selected (i.e., 
"active"), WISP will prompt the user for a file name.  Refer
to the Options Option and Menu section for information on
how to add the users favorite editor to WISP.

Pre-Processor Option and Menu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The only pre-processor available for the WASP model system
is PREDYN, a pre-processor program designed for the DYNHYD
model.

Execute Option and Menu
~~~~~~~~~~~~~~~~~~~~~~~
As mentioned in the File Option and Menu section above, WISP
can determine the type of file that the user has selected
from the File Select option.  If the user selects an input
file as "active", then selects the execute option, WISP
executes the appropriate WASP model by providing the input
file name, based on the file contents, to either the TOXI,
EUTRO, or DYNHYD model.  After selecting execute, WISP (1)
writes a small file to disk, swaps itself out of memory
(leaving only 4K resident), and runs the appropriate model
executable file.  Once the model simulation is complete,
WISP automatically re-loads itself in memory.

     NOTE:  WISP will not allow or display the execute
     option unless the user has selected a valid WASP
     input data file name.

Post Process Option and Menu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There are two programs available that can be used to post-
process output from the WASP models--tabular (W5DSPLY) and
graphical (PLOT).  The tabular post processor can handle
simulation files of any size; the graphical post processor
has a memory limitation of 30 segments over 40 dump
intervals.

After selecting the post process option, the user is
prompted to select either tabular or graphical.  If post
processing is selected and the active file (refer to File
Option and Menu) is an input file, WISP assumes that post
processing should be performed on the simulation result
files by the same file name.  For example, if the active
file is the input file name POND1.INP, then post processing
will be performed on the files POND1.TDF, POND1.EDF, 
POND1.DDF, etc.

The tabular post processor program will read the active file
into memory and then prompt the user for further
information.  For example, this program is capable of
building dynamic tables based on the users selection
criteria.  These tables can be written to disk (i.e., stored
in a file) or routed to a printer.  If the file is stored on
disk, it can be imported into a spreadsheet program for
statistical and graphical manipulation.

WISP also includes a "Hot Link" to a user provided
spreadsheet program.  After completing the selection
criteria and displaying a valid table, the user can return
to the tabular post processor main menu.  Pressing <ALT><S>
starts the execution of the spreadsheet program.  If the
user has not given the path and spreadsheet executable file
name (*.EXE) to WISP, it will prompt the user for the file
name path before execution (i.e. C:\LOTUS\LOTUS).  Once the
spreadsheet program is loaded, the user must import the file
using the import feature for comma delimited files.  The
spreadsheet file created by the post processor will have a
file name extension of SPR.

The graphical processor is contained within the tabular post
processing system (i.e. select the graphical option from
within the W5DSPLY program).  Graph types include XY-Line,
Bar, Histogram, and 3-dimensional plots.

Options Option and Menu
~~~~~~~~~~~~~~~~~~~~~~~
The Options menus allows the user to configure the WISP
operating environment to his or her preference.  For
example, the user can customize and/or change the display
colors, default editor, view and/or print the user support
documents, or see a brief description of example input
files.

4)   To execute the PREDYN program in stand-alone (non-WISP) 
     mode, type

     C:\WASP5> AIDEDYN <Enter>
               -------


5)   To execute the TOXI, EUTRO, and/or DYNHYD model programs in 
     stand-alone (non-WISP) mode, type

     C:\WASP5> TOXI5 <Enter>
               -----

     or

     C:\WASP5> EUTRO5 <Enter>
               ------

     or

     C:\WASP5> DYNHYD5 <Enter>
               -------

     respectively.



_________________________________________________________________

RUN TIME AND PERFORMANCE

The following run times (approximate) were observed using the
test data files furnished with the distribution version of the
WASP 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 WASP 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
5.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 50
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 WASP Model System Test Runs

                                       Approx. Run Time
    Model Name     Input File Name         (min:sec)
    ~~~~~~~~~~     ~~~~~~~~~~~~~~~     ~~~~~~~~~~~~~~~~
       TOXI            POND1.INP             00:30
       TOXI         POND3SEQ.INP             00:32
       TOXI          SEDPOND.INP             00:15
       TOXI         SEDPOND3.INP             09:47
       TOXI          TOXRIV1.INP             00:26
       TOXI          TOXRIV2.INP             00:25

      EUTRO             LAKE.INP             00:29
      EUTRO            RIVER.INP             00:15
      EUTRO           T-LAKE.INP             01:32

      DYNHYD          DYNRIV.INP             00:13
      DYNHYD          RIVERQ.INP             01:00
      DYNHYD          CANAL_H.INP            00:38

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

     o available disk space
     o available memory
     o CONFIG.SYS 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 the WASP model system and all support command files.

This list assumes that

     o the WASP model system and all support files and programs 
       have been successfully installed from the distribution
       diskettes
     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.

READ.ME      - WASP model system execution and general support 
               guide
USERMANA.DOC - WASP modeling system user's manual, part A
USERMANB.DOC - WASP modeling system user's manual, part B
DYNHYD5.DOC  - DYNHYD program user's manual

WISP.EXE     - Executable task image file for the WASP 
               Interactive Support Program (WISP)
WISP.HLP     - WISP program run time support files that are read
WISP.OPL       automatically by the WISP executable task image
WISP.OVR       file (WISP.EXE).
PKZIP.EXE    - Executable task image file for the PKWARE file 
               compression program
PKUNZIP.EXE  - Executable task image file for the PKWARE file 
               uncompression program

F77L3.EER    - Run time error message library file for Lahey 
               FORTRAN (F77L3)
MESSFILE.DAT - WASP run time status message files
DYNMES.DAT
WASP.ERF

TOXI5.EXE    - Executable task image file for the toxic chemical 
               model
EUTRO5.EXE   - Executable task image file for the eutrophication 
               model

AIDEDYN.BAT  - DOS batch command file used to execute the DYNHYD 
               model preprocessor program
TERM.DAT     - ANNIE-IDE system specification (terminal 
               definition) file used by the PREDYN program
MESSAGE.WDM  - Screen definition file read by the PREDYN program
PREDYN.EXE   - Executable task image file for the DYNHYD model 
               preprocessor program

                    WARNING:  This task image file
                    (PREDYN.EXE) should only be executed
                    using the DOS batch command file
                    provided if executed outside WISP
                    (AIDEDYN.BAT).

PREDYN.HLP   - Run time help message files read automatically by
KEYWORDS.DAT   the PREDYN program

DYNHYD5.EXE  - Executable task image file for the DYNHYD program

EDITOR.EXE   - Executable task image file for the EDITOR program
W5DSPLY.EXE  - Executable task image file for the W5DSPLY tabular
               post processor program
W5DSPLY.TXT  - WASP display program run time status message and
W5DSPLY.HLP    help files read automatically by the W5DSPLY
               program executable task image file (W5DSPLY.EXE)
PLOT.EXE     - Executable task image file for the PLOT graphical
               post processor program

*.INP        - Input data files as provided and named by the user
               for the WASP model system.



_________________________________________________________________

MODIFICATION

Included in the diskette set are

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

The Lahey FORTRAN compiler and Phar Lap 386LINK link editor are
NOT required to execute any portion of the WASP model system.  If
the user wishes to modify any of the WASP models, 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

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

For questions and/or information concerning

     o installation and/or testing of the WASP model system
       and/or support programs or files, call 706/546-3524 for
       assistance
     o WASP model system and/or program content, application,
       and/or theory, call 706/546-3323 for assistance
     o use of the CEAM electronic bulletin board system (BBS),
       contact the BBS system operator (SYSOP) at 706/546-3524
     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. Dermont
       Bouchard, CEAM Manager

       - by mail at the following address

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

       - by telephone at 706/546-3130
       - by fax at 706/546-3340
       - 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:\WASP5) 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, call the CEAM BBS 24 hours a
day, 7 days a week.  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



_________________________________________________________________

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 the WASP 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 authors can assume responsibility for
model and/or program modification, content, output,
interpretation, or usage.

CEAM software products are built using FORTRAN-77, assembler, 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 scientific and/or application support for selected
products if the user proves that a given product is installed and
working correctly.

     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.


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

DWD/dwd - September 1993 - E:\WASP\DOCUMENT\READ.DOC
