                                                File:     READ.ME

                            PATRIOT
Pesticide Assessment Tool for Rating Investigations of Transport
                          Version 1.20

                U.S. EPA Release, November 1994


         Center for Exposure Assessment Modeling (CEAM)
         U.S. Environmental Protection Agency (U.S. EPA)
            Office of Research and Development (ORD)
         Athens Environmental Research Laboratory (AERL)
                    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 Pesticide Assessment Tool for Rating Investigations of 
Transport (PATRIOT) is designed to provide rapid analyses of 
ground water vulnerability to pesticides on a regional, state, or 
local level.  PATRIOT assesses ground water vulnerability by 
quantifying pesticide leaching potential in terms of the
pesticide mass transported to the water table.  This software
package integrates, in a PC environment, a tool that enables
analysis of pesticide leaching potential with the data required
for area-specific analysis anywhere in the conterminous U.S. 
PATRIOT is composed of 1) a pesticide fate and transport model
(PATRIOT), 2) a comprehensive database, 3) an interface that
facilitates database exploration, 4) a directed sequence of
interaction that guides the user in providing all the necessary
information to perform alternative model analyses, and 5)
user-selected methods of summarizing and visualizing model
results.

This software system contains context sensitive, on-line,
interactive help that uses hypertext file operations (refer to
DOCUMENTATION section).

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

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



_________________________________________________________________

ABSTRACT

Refer to file ABSTRACT.TXT for an abstract of the PATRIOT Model
System (refer to FILE NAME AND CONTENT section).



_________________________________________________________________

DOCUMENTATION

It is recommended that the user obtain and reference the
documents listed below to operate and apply the PATRIOT model
system.

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

     NOTE:  The PATRIOT model system includes on-line,
     context sensitive help that can be invoked by the user
     by pressing the <F1> key during the execution of the
     program.  Information is shown as a hypertext document
     within help window and/or box on the screen.  This
     constitutes and replaces the need for a printed "user's
     manual".  Assistance is provided in the interactive
     operation and scientific application of the PATRIOT
     model system through this mechanism.

Document Name(s)                               File Name(s)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     ~~~~~~~~~~~~
PATRIOT model system general execution and         READ.ME
     user support guide
PATRIOT Model System Release Notes              RELEASE.TXT
PATRIOT Model System Update Notes                UPDATE.TXT
     (Enhancements/updates/additions not
     covered in help window and/or box)
PATRIOT Model System Abstract                  ABSTRACT.TXT
ANNIE-IDE (AIDE) System Specification File     TERM_DAT.TXT
     (TERM.DAT) Quick Reference Guide
PATRIOT Model System Example 1                 PATEXAM1.TXT
PATRIOT Model System Example 2                 PATEXAM2.TXT

CEAM Software Product User Response Form       RESPONSE.TXT

These documents should be retained by the requester for future
reference.

     NOTE:  The files READ.ME, RELEASE.TXT, UPDATE.TXT,
     ABSTRACT.TXT, TERM_DAT.TXT, PATEXAM1.TXT, PATEXAM2.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).



_________________________________________________________________

DISTRIBUTION DISKETTES

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

Included are 4, 3.5 inch (1.44mb, DS/HD) DOS (Disk Operating
System) formatted diskettes containing the Pesticide Assessment
Tool for Rating Investigations of Transport model system
(PATRIOT, Version 1.20), dated November, 1994.

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 PATRIOT 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 Pesticide
Assessment Tool for Rating Investigations of Transport model
system (PATRIOT, Version 1.20), dated November, 1994.

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

                            INSTALPT

     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 INSTALPT.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 PATRIOT 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

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

Follow the instructions shown on the interactive installation
program screens and menus to install, decompress (extract), and
restore file(s) to their original name and size in order to place
the PATRIOT 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 INSTALPT command can
     extract one or more PATRIOT 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
     INSTALPT 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 INSTALPT.  Below the
     installation directory, all files are grouped and
     listed by the appropriate DOS sub-directory name into
     which they will be automatically stored.


**  Sub-directory InstallationDirectory\README:

READ.ME      - PATRIOT model system execution and general support
               guide.  This is an ASCII text (non-binary) 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 (non-
               binary) 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 the current interactive, on-line,
               context sensitive help windows and boxes.  This is
               an ASCII text (non-binary) file that can be
               displayed on the monitor screen with the DOS TYPE
               command or printed using the DOS PRINT command.

ABSTRACT.TXT - PATRIOT Model System Abstract.  This is an ASCII
               text (non-binary) 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.

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

PATEXAM1.TXT - PATRIOT Model System Examples 1 and 2.  These
PATEXAM2.TXT   files list example PATRIOT model system execution
               key strokes and commands that coincide with -- and
               can be automatically executed from within -- the
               PATRIOT program with the interactive log files
               PATEXAM1.LOG and PATEXAM2.LOG.  These keystrokes
               and commands can be executed interactively by the
               user by following the sequence listed in each
               file.

               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.


**  Sub-directory InstallationDirectory:

F77L3.EER    - Run time error message library file for Lahey
               FORTRAN (F77L3) (refer to DEVELOPMENT SYSTEM
               section).  This file is read automatically during
               execution of the PATRIOT model system executable
               task image files (*.EXE) if an error is detected
               during execution.

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.

PATRIOT.BAT  - DOS batch command file used to execute the PATRIOT
               model.  To execute, type

               PATRIOT

               at the DOS system prompt, press the <Enter> key,
               then respond to the information screen and/or
               prompt displayed on the monitor screen.  For
               further information on executing PATRIOT, refer to
               the ROUTINE EXECUTION section.

     NOTE:  To execute the PATRIOT.BAT batch command file,
     and hence the PATRIOT model, from any sub-directory
     located on a hard or virtual disk drive, add the
     PATRIOT installation sub-directory (e.g., C:\PATRIOT)
     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:\PATRIOT

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

PAT_OPEN.SCR - Initial welcome and CEAM information screen
               displayed before the execution of the PATRIOT
               model by the DOS batch command file PATRIOT.BAT. 
               This is an ASCII text (non-binary) file that can
               be displayed on the monitor screen with the DOS
               TYPE command or printed using the DOS PRINT
               command.

TERM.DAT     - ANNIE-IDE system specification (terminal
               definition) file used by the PATRIOT model system. 
               The ANNIE-IDE library files used to build the
               PATRIOT model system 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 PATRIOT model system is stored.  Refer
               to the file TERM_DAT.TXT for further information
               on the modification and/or use of the TERM.DAT
               file.

COMPUTER.SMB - INTERACTER computer related symbol set file that
               is read automatically by the PATRIOT model system.

INTERACT.INI - INTERACTER initialization data file that is read
               automatically by the PATRIOT model system.

SIMPLEXR.CHR - INTERACTER simplex Roman character set file that
               is read automatically by the PATRIOT model system.

EHP.INI      - Binary (non-text) Expert Help initialization file
               read automatically by the PATRIOT model system.

BOUNPATH     - ASCII text file that contains the path and/or file
               name of the boundary file.  This file is read
               automatically by the PATRIOT model system.

PAT.NG       - Binary (non-text) Expert Help message file read by
               the PATRIOT model system.

GEOMLRA.DAT  - Binary (non-text) data base files read by the
CHEM.DAT       PATRIOT model system.
CROPMLRA.DAT
GEOHUC.DAT
GEOSTCO.DAT
SOIMLRA.DAT
SOIHUC.DAT
SOISTCO.DAT
SOI.DAT

MESSAGE.WDM  - Screen definition files read automatically by the
PRECIP.WDM     PATRIOT model system.  These are used to produce
PATMAP.WDM     and display on the monitor screen the text,
               application program menus, and data entry screens. 
               These are unformatted, binary (non-ASCII), direct
               access files with a logical record length of 2,048
               bytes.

XPATRIOT.EXE - Executable task image files for the PATRIOT model
EHP.EXE        and Expert Help systems.

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

PATEXAM1.LOG - Example interactive command (macro) input files to
PATEXAM2.LOG   test the installation and demonstrate application
               of the PATRIOT and PRZM2 model systems.  These
               command files are also furnished to provide
               instruction by example and can be used as
               templates for the preparation of new macro files
               and/or keystroke/command sequences.

               To test installation using these macro command
               files, execute the PATRIOT model (refer to ROUTINE
               EXECUTION section), press the <@> or <Shift><2>
               key(s) from the PATRIOT program Opening screen,
               type the macro file name of interest (e.g.,
               PATEXAM1.LOG) at the "Enter macro name:" prompt,
               then press the <Enter> key.  The user can review
               data entry, option selection, and execution of the
               PATRIOT and PRZM2 models, view graphs and figures,
               and view maps.

               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:  All PATRIOT model application (non-system) input
     and output files (with the exception of the *.WDM,
     *.DAT, and *.NG files) 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 (non-binary) format.

     NOTE:  A file name path specification and/or file name
     must be a unique and valid DOS path and/or file name. 
     A file name must also be a valid PATRIOT and/or PRZM2
     file name -- either furnished with the distribution
     package or created, designated, and named by the user. 
     Remember, a DOS file name can be from 1 to 8 characters
     and can have an optional 1 to 3 character file name
     extension.


Special Run Time Files

     NOTE:  The following file(s) are not distributed with
     the distribution release.  They are created and/or
     updated (appended to) automatically when the user
     executes the PATRIOT and PRZM2 model systems.

PAT__RUN.LOG - Run time log file that contains a beginning and
               ending date and time stamp for each execution of
               the PATRIOT model.  Refer to the ROUTINE EXECUTION
               section for further information.  This file can be
               cleaned up (i.e., deleted) at any time by the
               user.

ERROR.FIL    - PATRIOT AIDE run time error and status message
               file.  This file can be cleaned up (i.e., deleted)
               at any time by the user.

APPLIC.LOG   - PATRIOT AIDE execution key stroke and command
               audit trail file.  This file is auto-created as a
               new file each time the user executes the PATRIOT
               model system.  It contains all the key strokes and
               commands used by the user in the current PATRIOT
               model system interactive session.  This file can
               be copied (i.e., saved) to another file name
               (e.g., MYAPPLIC.LOG) and then used as a
               interactive command (macro) input file.  Refer to
               files PATEXAM1.LOG and PATEXAM2.LOG for further
               information.

XPAD.DAT     - PATRIOT AIDE scratch pad file.

*.INP        - PRZM2 model system input, output, and restart
*.OUT          files.  For further information on these files,
*.PRZ          refer to the user's manual and addendum files as
*.RUN          distributed with version 2.00 of the PRZM2 model
*.PRN          system.  These files are created during the
               execution of the PATRIOT and PRZM2 models.



_________________________________________________________________

DEVELOPMENT SYSTEM

The following list describes the language and program development
tools used by the Center for Exposure Assessment Modeling to
build version 1.20 of the microcomputer implementation of the
PATRIOT 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 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 PATRIOT 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 file 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
                            INTERACTER version 1.40

     Overlay Structure:     None - linked as flat memory model

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

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

                            640k base (low end) memory, plus
                            10.0m bytes of free extended (XMS)
                            memory and 14.0m bytes of free disk
                            space; or, 1m byte of free extended
                            (XMS) memory and 23.0m bytes disk
                            space

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

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

 Numerical Coprocessor:     Required.

\CONFIG.SYS Statements:     BREAK=ON
                            BUFFERS=20 or BUFFERS=32
                            FILES=80
                            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 PATRIOT 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
     PATRIOT 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 PATRIOT model
     system.

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

DOS Storage Path
~~~~~~~~~~~~~~~~
Verify that the PATRIOT model 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 the PATRIOT.BAT batch command file,
     and hence the PATRIOT model, from any sub-directory
     located on a hard or virtual disk drive, add the
     PATRIOT installation sub-directory (e.g., C:\PATRIOT)
     to the DOS search PATH and copy the file PATRIOT.RUN
     and 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:\PATRIOT

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

     C:\> CD \PATRIOT<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 PATRIOT model, type:

     C:\PATRIOT> PATRIOT<Enter>
                 -------

     After an opening banner/registration screen is displayed on
     the monitor, press the <Enter> key to clear the screen and
     continue model execution.  The model will begin prompting
     the user for information needed for this run of the model. 
     The user should respond to any information screens, menus,
     and/or prompts displayed on the monitor screen.

Viewing Output Results
~~~~~~~~~~~~~~~~~~~~~~
After executing the PATRIOT model executable task image file
(*.EXE), the user can view an output file, if any, produced by
the execution of the PATRIOT and/or PRZM2 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 or in a run time supervisor file.  A word
processor or text editor is convenient for this purpose, or the
command

                    TYPE filename.ext | MORE

can be used where "filename.ext" is the name of the output file. 
However, the TYPE command is awkward for output files that
exceeds 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.ext" must be a unique and valid DOS path
and/or file name.  The user response "filename.ext" must also be
a valid PATRIOT 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 PATRIOT 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, MYAPPLIC.LOG).

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

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 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 test the PATRIOT model system and all support command
files and programs.

This list assumes that

     o the PATRIOT 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      - PATRIOT 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 help window and/or box.
ABSTRACT.TXT - PATRIOT Model System Abstract.
TERM_DAT.TXT - ANNIE-IDE System Specification File (TERM.DAT)
               Quick Reference Guide.
RESPONSE.TXT - CEAM Software Product User Response Form.
PATEXAM1.TXT - PATRIOT Model System Examples 1 and 2.
PATEXAM2.TXT


**  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.
PATRIOT.BAT  - DOS batch command file used to execute the PATRIOT
               model.
PAT_OPEN.SCR - Initial welcome and CEAM information screen.
TERM.DAT     - ANNIE-IDE system specification (terminal
               definition) file.
COMPUTER.SMB - INTERACTER computer related symbol set file.
INTERACT.INI - INTERACTER initialization data file.
SIMPLEXR.CHR - INTERACTER simplex Roman character set file.
EHP.INI      - Binary (non-text) Expert Help initialization file.
BOUNPATH     - ASCII text file that contains the path and/or file
               name of the boundary file.

PAT.NG       - Binary (non-text) Expert Help message file.
GEOMLRA.DAT  - Binary (non-text) data base files read by the
CHEM.DAT       PATRIOT model system.
CROPMLRA.DAT
GEOHUC.DAT
GEOSTCO.DAT
SOIMLRA.DAT
SOIHUC.DAT
SOISTCO.DAT
SOI.DAT

MESSAGE.WDM  - Screen definition files read automatically by the
PRECIP.WDM     PATRIOT model system.
PATMAP.WDM

XPATRIOT.EXE - Executable task image file for the PATRIOT model
EHP.EXE        and Expert Help systems.

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

PATEXAM1.LOG - Example interactive command (macro) input files.
PATEXAM2.LOG



_________________________________________________________________

MODIFICATION

Included with the distribution release are

     o executable task image files for the PATRIOT model system

A FORTRAN compiler and link editor are NOT required to execute
any portion of the PATRIOT model system.  If the user wishes to
modify any portion of the PATRIOT 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 source code
     o FORTRAN program and user interface development tools
       listed in the DEVELOPMENT SYSTEM section to recompile and
       link edit any model and/or program

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 PATRIOT 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 PATRIOT model system
       and/or support programs or files, call 706/546-3590 for
       assistance or send mail via Internet to
       ceam@athens.ath.epa.gov
     o model content, theory and/or application, call 706/546-
       3210 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. Dermont
       Bouchard, CEAM Manager

       - by mail at the following address

         Center for Exposure Assessment Modeling (CEAM)
         Athens Environmental Research Laboratory
         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 ceam@athens.ath.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:\PATRIOT) 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

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

                         earth1.epa.gov

The PATRIOT 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, and QUICKREF.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 earth1 connection (type 'open
earth1.epa.gov'), log onto earth1 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, selected CEAM software products,
including PATRIOT, can be accessed at the following Universal
Resource Locator (URL):

      file://earth1.epa.gov/epa_ceam/wwwhtml/ceam_home.html



_________________________________________________________________

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 PATRIOT 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 PATRIOT 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, 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 - November 1994 - E:\PATRIOT\README\READ.ME
