File: README.TXT PRZM2 Pesticide Root Zone Model - Release 2 Version 2.00 U.S. EPA Release, October 1994 Center for Exposure Assessment Modeling (CEAM) National Exposure Research Lab - Ecosystems Research Division Office of Research and Development (ORD) U.S. Environmental Protection Agency (U.S. EPA) 960 College Station Road Athens, Georgia 30605-2700 706/355-8400 _________________________________________________________________ CONTENTS Introduction Documentation Installation File Name and Content Development System Routine Execution Run Time and Performance Minimum File Configuration Modification Technical Help Contact Disclaimer _________________________________________________________________ INTRODUCTION PRZM2 links two subordinate models, PRZM and the Vadose Zone Flow and Transport Model (VADOFT) to provide a deterministic simulation of fate of agricultural pesticides in the crop root zone and the underlying unsaturated zone. It is capable of simulating multiple pesticides or pesticide parent and daughter product relationships, and estimating probabilities of concentrations or fluxes in or from various media for the purpose of performing exposure assessments. The PRZM and VADOFT codes are linked together in PRZM2 through a flexible execution supervisor that allows the user to build loading modules tailored to site-specific situations. In order to perform probability-based assessments, the code is equipped with a Monte Carlo pre-and post-processor. Updated documentation, and the PRZM2 to WASP and HSPF bridge programs are included. For a list of modifications since the last release of the PRZM model system, refer to the files RELEASE.TXT, UPDATE.TXT, and PRZDOCAD.DOC (refer to FILE NAME AND CONTENT section). NOTE: For convenience, the terms "PRZM2 model system" or "PRZM2" will be used in this document to refer to the PRZM2 model and all associated support files and programs as a single unit. Therefore, the term "PRZM2" is synonymous with "PRZM2 model system" for purposes of this document. _________________________________________________________________ DOCUMENTATION It is recommended that the user obtain and reference the documents listed below to operate and apply the PRZM2 model system. Copies of the following documents are included on the distribution file Install_PRZM200.EXE. Refer to FILE NAME AND CONTENT and MINIMUM FILE CONFIGURATION sections for further information. Document Name(s) File Name(s) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~ PRZM2 model system general execution and README.TXT user support guide PRZM2 Model System Release Notes RELEASE.TXT PRZM2 Model System Update Notes UPDATE.TXT (Enhancements/updates/additions not covered in user's manual) PRZM2 Model System Abstract ABSTRACT.TXT PRZM2 Model System User's Manual USERSMAN.DOC Model Enhancements and Description of PRZDOCAD.DOC Bridge Programs for PRZM-2/HSPF and PRZM-2/WASP Applications--Addendum to the Users Manual for Release 2.0 of the PRZM-2 Model. CEAM Software Product User Response Form RESPONSE.TXT These documents should be retained by the requester for future reference. NOTE: The files README.TXT, RELEASE.TXT, UPDATE.TXT, ABSTRACT.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 README.TXT) or printed using the DOS PRINT command (e.g., PRINT README.TXT). File names with a file name extension of ".DOC" are WordPerfect (binary) document files that can only be viewed and/or printed within WordPerfect. _________________________________________________________________ INSTALLATION The PRZM-3 installation file, Install_PRZM200.EXE, may be acquired either from the Internet or CD-ROM. Save the installation file to a local disk before running the installation program. To install PRZM-2: Close all applications and click on the installation program "Install_PRZM200.EXE". Follow the instructions presented by the installation program. 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. _________________________________________________________________ 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 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 PRZM2 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_PRZM200.EXE command will extract all PRZM2 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. The string "InstallationDirectory" will be used to denote the highest level default installation directory structure chosen by the user during installation. The files are listed by DOS sub-directory name. 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: README.TXT - PRZM2 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 user's manual. 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 - PRZM2 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. 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. ** Sub-directory InstallationDirectory\DOCUMENT NOTE: The following file(s) are NOT required to execute and/or test any model, program, or associated run time support file as provided in the distribution file. For further information, refer to the MINIMUM FILE CONFIGURATION section. File names with a file name extension of ".DOC" are WordPerfect (binary) document files that can only be viewed and/or printed within WordPerfect. USERSMAN.DOC - PRZM-2, A Model for Predicting Pesticide Fate in the Crop Root and Unsaturated Soil Zones: Users Manual for Release 2.0 PRZDOCAD.DOC - Model Enhancements and Description of Bridge Programs for PRZM-2/HSPF and PRZM-2/WASP Applications--Addendum to the Users Manual for Release 2.0 of the PRZM-2 Model. ** 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 PRZM2 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 key or null response to an input prompt in selected DOS batch command files. PRZM2.BAT - DOS batch command file used to execute the PRZM2 model. To execute, type PRZM2 at the DOS system prompt, press the key, then respond to the information screen and/or prompt displayed on the monitor screen. For further information on executing PRZM2, refer to the ROUTINE EXECUTION section. NOTE: To execute the PRZM2.BAT batch command file, and hence the PRZM2 model, or the PRZM2 to HSPF or WASP bridge programs from any sub-directory located on a hard or virtual disk drive, add the PRZM2 installation sub-directory (e.g., C:\PRZM2) to the DOS search PATH and copy the file PRZM2.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:\PRZM2 Refer to the DOS Reference Manual for PATH command and AUTOEXEC.BAT file application and use. PRZMOPEN.SCR - Initial welcome and CEAM information screen displayed before the execution of the PRZM2 model by the DOS batch command file PRZM2.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. PRZM2.RUN - Run time supervisor (command) file for PRZM2. This file contains file name(s) and other run time information, parameter values, input/output file storage path(s) and name(s), and/or setting(s) used during the execution of the PRZM2 model. To use the run time supervisor file, edit the file with a text editor that saves a file to disk in ASCII (non-binary) text format. This file is read automatically by the PRZM2 model and 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. XPRZM2X.EXE - Executable task image file for the PRZM2 model. WARNING: This task image file (XPRZM2X.EXE) should only be executed using the DOS batch command file provided (PRZM2.BAT). PRZ2HSPF.WDM - PRZM2 to HSPF WDM file containing input pesticide flux data sets and output data sets. This is an unformatted, direct access data file read automatically during the execution of the PRZM2 to HSPF bridge program executable task image file (PZ2HSPF.EXE). The name of this file can be specified within a PZ2HSPF bridge program input data file (refer to files PRZ2HSPF.INP and PRZDOCAD.DOC for further information and examples). PZ2HSPF.EXE - Executable task image file for the PRZM2 to HSPF bridge program. To execute, type PZ2HSPF at the DOS system prompt, press the key, then respond to the prompt displayed on the monitor screen. For further information on executing PZ2HSPF, refer to the ROUTINE EXECUTION section. PRZM?EXA.D?? - Nine (9) separate EXAMS files, one for each year, generated by PRZM2. All yearly output files have to be specified in the PRZM2 to WASP bridge program input (parameter) file. These data files are read automatically during the execution of the PRZM2 to WASP bridge program executable task image file (PZ2WASP.EXE). The name of these files are specified within a PZ2WASP bridge program input data file (refer to files PRZ2WASP.INP and PRZDOCAD.DOC for further information and examples). PZ2WASP.EXE - Executable task image file for the PRZM2 to WASP bridge program. To execute, type PZ2WASP at the DOS system prompt, press the key, then respond to the prompts displayed on the monitor screen. For further information on executing PZ2WASP, refer to the ROUTINE EXECUTION section. PRZ2HSPF.INP - Example input data files to test the installation PRZ2WASP.INP and demonstrate application of the PRZM2 to HSPF and WASP bridge programs. These data files are also furnished to provide instruction by example and can be used as templates for the preparation of new input files. To test installation, execute the PZ2HSPF and/or PZ2WASP programs using these files respectively as the name of input files. Each program interactively prompts the user for an input file name and/or output file name(s). ** Sub-directory InstallationDirectory\INPUT NOTE: All PRZM2 model, and PZ2HSPF and PZ2WASP program input files (with the exception of the WDM file) 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, as typed within the PRZM2 run time supervisor file, PZ2HSPF input data file, or at a run time prompt by the user, must be a unique and valid DOS path and/or file name. An input file name must also be a valid PRZM2, PZ2HSPF, or PZ2WASP input data file name -- either furnished with the distribution package or created, designated, and named by the user. A file name used in the PRZM2 run time supervisor file as input data for the PRZM2 model or typed at a run time prompt for either the PZ2HSPF or PZ2WASP program will be processed and executed in the run of the 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. NOTE: Refer to the explanation of the *.OOO, PRZ2HSPF.OUT, and/or PRZ2WASP.NPS and PRZ2WASP.RNF files for a procedure to compare the contents of an output file produced on the users system (*.OUT, .NPS, .RNF) to an output file provided in the file Install_PRZM200.EXE. The user can specify input and output file name(s) in the run time supervisor file PRZM2.RUN (refer to explanation of PRZM2.RUN file) for the PRZM2 model, and at run time prompts displayed on the monitor screen for either the PZ2HSPF or PZ2WASP programs. *.INP - Example input data files (11) to test the installation and demonstrate application of the PRZM2 model. These data files are also furnished to provide instruction by example and can be used as a template for the preparation of new input files. To test the installation, execute the PRZM2 model using the PRZM2.RUN run time supervisor file included in the distribution file Install_PRZM200.EXE. This supervisor file is configured to use the input files PRZM3.INP, VADF3.INP, and MET.INP stored within the INPUT sub-directory, and produce the output files PRZM.OUT, VADF.OUT, and TIMES.OUT within the sub-directory OUTPUT. ** Sub-directory InstallationDirectory\OUTPUT: NOTE: The symbol "" represents pressing the 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 (<>). *.OOO - Output listing files (3) produced by the PRZM2 model using test input data files PRZM3.INP, VADF3.INP, and MET.INP that are provided with the distribution release. The run time supervisor file PRZM2.RUN, as distributed by CEAM, is configured to read and process these input files and produce the output listing files PRZM.OUT, VADF.OUT, and TIMES.OUT. After executing the PRZM2 model with the default supervisor file, compare the contents of the output files produced (i.e., OUTPUT\.*.OUT) with the corresponding output files provided (i.e., OUTPUT\*.OOO). To compare file contents, use the COMP (PC DOS) or FC (MS DOS) file compare command, or print files then compare contents by hand. Example PRZM2 interactive (non-batch) execution and file comparison sequence: 1) Set the default drive to the disk containing the PRZM2 model system sub-directory: A:\> C: -- 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., PRZM2). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \PRZM2 --------- 3) Execute the PRZM2 model. C:\PRZM2> PRZM2 ----- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (PRZM2 banner/registration screen displayed here...press the key to clear screen and continue model execution...) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (The following screen is displayed next while the PRZM2 program is loaded into memory.) # # ## Loading PRZM2 task image file...wait. # #------------------------# ## PRZM2 run beginning. #------------------------# # ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 32-bit Power for Lahey Computer Systems º º Phar Lap's 386|DOS-Extender(tm) Version 4.1L º º Copyright (C) 1986-92 Phar Lap Software, Inc. º º Available Memory = xxxxx Kb º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Where xxxxx is a number that represents the available RAM memory on the host system, expressed in K bytes (K=1,024), that will be filled in automatically by the PRZM2 executable task image file.) (NOTE: The PRZM-2 Version 2.00 Execution Supervisor run time diagnostic and information status screen and messages displayed here while the model executes.) (Once execution is complete the following messages are displayed on the monitor screen.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Returning to Operating system ## PRZM2 program execution complete. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Compare the output files supplied to those produced.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C:\PRZM2> COMP OUTPUT\*.OOO OUTPUT\*.OUT ------------------------------ or, C:\PRZM2> FC OUTPUT\*.OOO OUTPUT\*.OUT ---------------------------- PRZ2HSPF.OUT - Output listing file produced by the PZ2HSPF program using the test input data file PRZ2HSPF.INP that is provided with the distribution release. After executing the PZ2HSPF program with this test data file, compare the contents of the output file produced (i.e., PRZ2HSPF.OUT) with the corresponding output file provided within the sub-directory OUTPUT (i.e., OUTPUT/PRZ2HSPF.OUT). To compare file contents, use the COMP (PC DOS) or FC (MS DOS) file compare command, or print both files then compare contents by hand. Example PZ2HSPF interactive (non-batch) execution and file comparison sequence: 1) Set the default drive to the disk containing the PZ2HSPF program sub-directory: A:\> C: -- 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., PRZM2). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \PRZM2 --------- 3) Execute the PZ2HSPF program. C:\PRZM2> PZ2HSPF ------- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (The following screen is displayed next while the PZ2HSPF program is loaded into memory.) ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 32-bit Power for Lahey Computer Systems º º Phar Lap's 386|DOS-Extender(tm) Version 4.1L º º Copyright (C) 1986-92 Phar Lap Software, Inc. º º Available Memory = xxxxx Kb º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Where xxxxx is a number that represents the available RAM memory on the host system, expressed in K bytes (K=1,024), that will be filled in automatically by the PZ2HSPF executable task image file.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ENTER THE INPUT PARAMETER FILENAME : PRZ2HSPF.INP ------------ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Compare the output file supplied to the one produced.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C:\PRZM2> COMP OUTPUT\PRZ2HSPF.OUT PRZ2HSPF.OUT ------------------------------------- or, C:\PRZM2> FC OUTPUT\PRZ2HSPF.OUT PRZ2HSPF.OUT ----------------------------------- PRZ2WASP.NPS - Output listing files produced by the PZ2WASP PRZ2WASP.RNF program using the test input data file PRZ2WASP.INP that is provided with the distribution release. After executing the PZ2WASP program with this test data file, compare the contents of the output files--as typed and named by the user at run time prompts--produced (e.g., PRZ2WASP.NPS, PRZ2WASP.RNF) with the corresponding output files provided within the sub-directory OUTPUT (i.e., OUTPUT/PRZ2WASP.*). To compare file contents, use the COMP (PC DOS) or FC (MS DOS) file compare command, or print the files then compare contents by hand. Example PZ2WASP interactive (non-batch) execution and file comparison sequence: 1) Set the default drive to the disk containing the PZ2WASP program sub-directory: A:\> C: -- 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., PRZM2). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \PRZM2 --------- 3) Execute the PZ2WASP program. C:\PRZM2> PZ2WASP ------- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (The following screen is displayed next while the PZ2WASP program is loaded into memory.) ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 32-bit Power for Lahey Computer Systems º º Phar Lap's 386|DOS-Extender(tm) Version 4.1L º º Copyright (C) 1986-92 Phar Lap Software, Inc. º º Available Memory = xxxxx Kb º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Where xxxxx is a number that represents the available RAM memory on the host system, expressed in K bytes (K=1,024), that will be filled in automatically by the PZ2WASP executable task image file.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ENTER THE INPUT PARAMETER FILENAME : PRZ2WASP.INP ------------ ENTER THE NONPOINT SOURCE INPUT FILE FOR WASP5.0 : PRZ2WASP.NPS ------------ ENTER THE RUNOFF FILENAME : PRZ2WASP.RNF ------------ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Compare the output files supplied to those produced. File comparisons should be repeated for the *.RNF files.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C:\PRZM2> COMP OUTPUT\PRZ2WASP.NPS PRZ2WASP.* ----------------------------------- or, C:\PRZM2> FC OUTPUT\PRZ2WASP.NPS PRZ2WASP.* --------------------------------- ** Sub-directory InstallationDirectory\PRZMCODE: ** Sub-directory InstallationDirectory\PRZ2HSPF: ** Sub-directory InstallationDirectory\PRZ2WASP: NOTE: The following file(s) are NOT required to document, execute and/or test any model, program, or associated run time support file as provided in the distribution file. For further information, refer to the MINIMUM FILE CONFIGURATION section. MAKEFILE - Lahey make files (3) that can be used to compile and/or link edit the PRZM2 model, PZ2HSPF, and/or PZ2WASP FORTRAN source code files (*.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 these commands can produce new executable task image files (XPRZM2X.EXE, PZ2HSPF.EXE, PZ2WASP.EXE) for the PRZM2 model, or PZ2HSPF and/or PZ2WASP programs. These command files only needs to be executed if changes have been made in the FORTRAN source code, not input data files. To execute, type MAKE at the DOS system prompt, then press the key. *.INC - FORTRAN source code "include" files containing FORTRAN COMMON block declarations for the PRZM2 model, or PZ2HSPF and/or PZ2WASP programs. These files are automatically included or "copied" into FORTRAN source code files (*.FOR) during compilation. *.FOR - FORTRAN source code files for the PRZM2 model, RSMAIN.PRG PRZHSPF program, and/or PZ2WASP program, version RSMAIN.SUB 2.00. ** Sub-directory InstallationDirectory: ** Sub-directory InstallationDirectory:\OUTPUT 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 PRZM2 model. PRZM2RUN.LOG - Run time log file that contains a beginning and ending date and time stamp for each execution of the PRZM2 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. KECHO.PRN - For further information on these files, refer to RESTART.PRZ the user's manual and addendum files (refer to VFLOW.RST DOCUMENTATION section). These files are created VTRANS.RST during the execution of the PRZM2 model. VADT.TAP _________________________________________________________________ DEVELOPMENT SYSTEM The following list describes the language and program development tools used by the Center for Exposure Assessment Modeling to build version 2.00 of the microcomputer implementation of the PRZM2 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 PRZM2 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 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 4.0m bytes of free extended (XMS) memory and 2.0m bytes of free disk space; or, 1m byte of free extended (XMS) memory and 6.0m bytes disk space Hard Disk Drive: 20m byte drive recommended (minimum) with 3.5m bytes free (minimum) Installation Size: Run Time: Approx. 1.9m bytes max. Document: Approx. 3.5m bytes max. FOR Code: Approx. .8m bytes max. ~~~~ Total 6.2m bytes (Total does not include *.OBJ if all source code files are compiled and linked.) Run time size: Up to approximately 2.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=20 DEVICE=C:\ANSI.SYS DEVICE=extended memory manager - and - SHELL=C:\COMMAND.COM C:\ /e:512 /p Printer: For *.DOC file only, HP LaserJet III PostScript or compatible printer. Printer Software: For *.DOC file only, WordPerfect version 5.1 or greater. _________________________________________________________________ ROUTINE EXECUTION NOTE: The symbol "" represents pressing the 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 PRZM2 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 PRZM2 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 PRZM2 model system. Introduction ~~~~~~~~~~~~ Complete the installation process to make the full or any portion of the PRZM2 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 PRZM2 model system. DOS Storage Path ~~~~~~~~~~~~~~~~ Verify that the PRZM2 model, the PRZM2 to HSPF or WASP bridge program executable task image files (*.EXE), DOS batch command files (*.BAT), other run time support files, PRZM2 run time supervisor file, 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 PRZM2.BAT batch command file, and hence the PRZM2 model, or the PRZM2 to HSPF or WASP bridge programs from any sub-directory located on a hard or virtual disk drive, add the PRZM2 installation sub-directory (e.g., C:\PRZM2) to the DOS search PATH and copy the file PRZM2.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:\PRZM2 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 PRZM2 model system sub-directory. For example: A:\> C: -- 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., PRZM2). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \PRZM2 --------- 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 PRZM2 model, type: C:\PRZM2> PRZM2 ----- After an opening banner/registration screen is displayed on the monitor, press the key to clear the screen and continue model execution. 4) To execute the PZ2HSPF model, type: C:\PRZM2> PZ2HSPF ------- The program will prompt the user for file name information needed for this run of the program. The user should respond to any prompts displayed on the monitor screen. 5) To execute the PZ2WASP model, type: C:\PRZM2> PZ2WASP ------- The program will prompt the user for file name information needed for this run of the program. The user should respond to any prompts displayed on the monitor screen. Viewing Output Results ~~~~~~~~~~~~~~~~~~~~~~ After executing the PRZM2 model, or the PZ2HSPF or PZ2WASP program executable task image files (*.EXE), the user can view an output file, if any, produced by the execution of a model or program 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 PRZM2 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 PRZM2 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). 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. NOTE: Refer to the explanation of the *.OOO and *.OUT files in the FILE NAME AND CONTENT section for a procedure to compare the contents of an output file produced on the users system to an output file provided with the distribution release. _________________________________________________________________ RUN TIME AND PERFORMANCE The following run times (approximate) were observed using the test data files furnished with the distribution version of the PRZM2 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 PRZM2 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 PRZM2 Test Runs Input File Name(s) Approx. Run Time (hr:min:sec) ~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~ PRZM.INP, VADF.INP 00:00:39 PRZM1.INP, VADF1.INP 00:01:01 PRZM2.INP, VADF2.INP 00:01:02 PRZM3.INP, VADF3.INP 00:00:57 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 the PRZM2 model system and all support command files and programs. This list assumes that o the PRZM2 model system and all support files and programs have been successfully installed 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: README.TXT - PRZM2 model system execution and general support guide. RELEASE.TXT - Summary of corrections and/or changes between release versions. UPDATE.TXT - Summary of enhancements, updates, and additions not covered in the current user's manual. ABSTRACT.TXT - PRZM2 Model System Abstract. ** 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. PRZM2.BAT - DOS batch command file used to execute the PRZM2 model. PRZMOPEN.SCR - Initial welcome and CEAM information screen. PRZM2.RUN - PRZM2 run time supervisor file. XPRZM2X.EXE - Executable task image file for the PRZM2 model. WARNING: This task image file (XPRZM2X.EXE) should only be executed using the DOS batch command file provided (PRZM2.BAT). PRZ2HSPF.WDM - PRZM2 to HSPF WDM file. PZ2HSPF.EXE - Executable task image file for the PRZM to HSPF bridge program. PRZM?EXA.D?? - Nine (9) separate EXAMS files, one for each year, generated by PRZM2. PZ2WASP.EXE - Executable task image file for the PRZM to WASP bridge program. ** Sub-directory InstallationDirectory\DOCUMENT USERSMAN.DOC - PRZM2 Model System User's Manual. PRZDOCAD.DOC - Model Enhancements and Description of Bridge Programs for PRZM-2/HSPF and PRZM-2/WASP Applications--Addendum to the Users Manual for Release 2.0 of the PRZM-2 Model. _________________________________________________________________ MODIFICATION Included with the distribution release are o executable task image files for the PRZM2 model system o FORTRAN source code files for IBM PC and compatible microcomputer systems (refer to DEVELOPMENT SYSTEM section) A FORTRAN compiler and link editor are NOT required to execute any portion of the PRZM2 model system. If the user wishes to modify any portion of the PRZM2 model system, it will be up to the user to supply and/or obtain o an appropriate text editor that saves files in ASCII text (non-binary) format o FORTRAN program development tools to recompile and link edit any model and/or program 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 For questions or information concerning the distribution or installation of PRZM-2 software, documentation, or data please contact CEAM at: Phone: 706-355-8400 Fax: 706-355-8104 E-mail: ceam@epamail.epa.gov Mail: Center for Exposure Assessment Modeling (CEAM) National Exposure Research Laboratory - Ecosystems Research Division U.S. Environmental Protection Agency (U.S. EPA) 960 College Station Road Athens, Georgia 30605-2700 CEAM operates and maintains a listserver system named CEAM-USERS. The CEAM-USERS listserver is an automated mailing list system which broadcasts up-to-date information concerning CEAM software product updates and releases as well as hints on software installation and use. Subscribers may broadcast messages to other list subscribers to ask and answer questions about exposure assessment modeling topics. Instructions for subscribing, posting messages, and managing membership setting are available on the CEAM Web site at the URL: http://www.epa.gov/ceampubl/listserv.htm _________________________________________________________________ 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 PRZM-3 model system, and modifications to the DOS system configuration files 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. The PRZM-3 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. ######################### DWD/dwd - October 1994 - E:\PRZM2\README\README.TXT Revised - April 2004