Dear AGNPS User:


Welcome to AGNPS version 5.00 FTP site.  The required AGNPS version 5.0 files 
that you will need to load and run the program successfully on your computer 
are located in the directories listed below.  IT IS NECESSARY THAT USERS 
DOWNLOAD ALL OF THE DOCUMENTATION AND READ IT THOROUGHLY 
BEFORE USING THE AGNPS VERSION 5.00 PROGRAM.

Steps for downloading files:

At the FTP prompt type: "open ftp.mrsars.usda.gov"
When prompted for user name type: "anonymous"
Use your E-mail address for a password. 
Next change directories to the appropriate directory - 
        Ex. "cd ftp/pub/ars/agnps/dos/version5"
Then type: "bin" (This stands for binary transfer)
Next type:"get <filename>"
If you want to download all of the files located on the directory you may 
type: "mget *"

Useful Unix commands for maneuvering on our FTP site.
cd - Change directory.
pwd - Present working directory.
ls - List directory and files.

Steps for installing the Dos version of AGNPS - agdos500.exe

Once you have downloaded agdos500.exe move to the directory that it is
located in and type "agdos500".  This will extract the self-extracting 
file and create a installation diskette on your hard drive. 
.  Next type "install" and follow the instuctions on the screen.
From this point on when prompted to insert a diskette simply hit enter
as you already have the files located on your hard disk

Before running the model it is necessary to make changes to your config.sys 
and autoexec.bat files. The neccessary configuration instructions may be 
found in chapter 1 of the AGNPS User's Manual or in the file gstart1.wp.

The following is a listing of the available files and the directories in which 
they are located.

Directory Map:   /ftp/pub/ars/agnps/doc/newslets
                                 ../dos/archives/agnps12
                                                /agnps252
                                                /agnps351
                                                /agnps365
                                                /agnps402
                                 ../version5/data 
                                            /verified/data/input.dat
                                                          /otherdat
                                                          /output.nps
                                                          /output.vt
                                                    /docs/document
                                                         /handcalc
                                 ../source/check
                                          /grafix
                                          /install
                                          /science
                                          /spread
                                          /srcaccnt
                                          /tabular
                                 ../unix

Directory - ftp/pub/ars/agnps

     about.txt - This file
     trnsmt50.txt - ASCII verification report letter



    
Directory - ftp/pub/ars/agnps/doc

     500in.txt - ASCII input format guide. 
     500in.wp - Word Perfect 6.0/6.1 for Windows input format guide
     500out.txt - ASCII Output format guide
     500out.wp - Word Perfect 6.0/6.1 for Windows output format guide
     agnpsref.txt - AGNPS reference list
     agnpsref.wp - Word Perfect 6.0/6.1 for Windows reference list
     gstart1.wp - Word Perfect 6.0/6.1 for Windows file containing information 
		  on computer system changes needed in order to successfully 
		  run the DOS version of the program.
     gislinks.txt - ASCII file listing contacts of user's who have worked on 
		    linking AGNPS with a GIS system.
     gislinks.wp - Word Perfect 6.0/6.1 for Windows file listing contacts of 
		   user's who have worked on linking AGNPS with a GIS system. 
     wpman40.exe - This is a self-extracting executable file that contains the 
		   following: User's Manual in Word Perfect 6.0/6.1 for 
		   Windows format, vrfsftwr.doc - Microsoft Word 6.0c for 
		   Windows - AGNPS Software Verification Report, vrfscien.doc 
		   - Microsoft Word 6.0c for Windows - AGNPS Software 
		   Verification Report and about.txt - This file.     
		   The 4.03 User's Manual is valid for version 5.00.  
		   After downloading this file to your computer simply type  
		   " wpman40" at the appropriate directory prompt and the 
		   files will  self extract.

     msman40.exe - This is a self-extracting executable file that contains 
		   the following :  User's Manual in Microsoft Word 6.0a for 
		   Windows format, vrfsftwr.doc - Microsoft Word 6.0c for 
		   Windows - AGNPS Software Verification Report, vrfscien.doc 
		   - Microsoft Word 6.0c for Windows - AGNPS Software 
		   Verification Report and about.txt - This file.  The 4.03 
		   Users Manual is valid for version 5.00.  After downloading 
		   this file to your computer simply type " Msman40" at the 
		   appropriate directory prompt and the files will self 
		   extract.        

     
     techdoc.exe - Self extracting executable file that contains Word Perfect 
		   6.0/6.1 for Windows files that provide sediment, hydrology, 
		   nutrient, and pesticide information.  After downloading 
		   this file to your computer simply type "techdoc" at the 
		   appropriate directory prompt and the files will self 
		   extract.        
     trnsmt50.txt - ASCII verification report letter
     vrfsftwr.doc - Microsoft Word 6.0c for Windows - AGNPS Software 
		    Verification Report
     vrfscien.doc - Microsoft Word 6.0c for Windows - AGNPS Software 
		    Verification Report

Directory - ftp/pub/ars/agnps/doc/newslets - AGNPS Newsletters
     
Directory - ftp/agnps/ftp/pub/ars/agnps/dos/archives/agnps12 - agdos12.exe AGNPS 1.2 Dos version

Directory - ftp/agnps/ftp/pub/ars/agnps/dos/archives/agnps252 - agdos252.exe AGNPS 2.52 Dos version

Directory - ftp/agnps/ftp/pub/ars/agnps/dos/archives/agnps351 - agdos351.exe AGNPS 3.51 Dos version

Directory - ftp/agnps/ftp/pub/ars/agnps/dos/archives/agnps365 - agdos365.exe AGNPS 3.65 Dos version

Directory - ftp/agnps/ftp/pub/ars/agnps/dos/archives/agnps252 - agdos402.exe AGNPS 4.02 Dos version

Directory - ftp/pub/ars/agnps/dos/version5

     agdos500.exe  - This is a self-extracting executable file that contains 
		     the model and User's Manual.   The 4.03 User's Manual is 
		     valid for version 5.00 and is in Microsoft Word for 
		     Windows 6.0a format and Word Perfect for Windows 6.0/6.1 
		     format.  After  downloading this file to your computer
		     simply type " agdos500" at the  appropriate directory 
		     prompt and the files will self extract. You would next 
		     type "install" and follow the instructions on the screen.  
     trnsmt50.txt - ASCII verification report letter

Directory - ftp/pub/ars/agnps/dos/version5/data - Contains various data files.

Directory - ftp/pub/ars/agnps/dos/version5/verified/data/input.dat - Contains AGNPS input
							data files used to verify AGNPS 5.00

Directory - ftp/pub/ars/agnps/dos/version5/verified/data/otherdat - Contains AGNPS input
							data files used to verify AGNPS 5.00
		.DAT file = Input data files
		.NPS file = output data files
		.OUT file = output data files
		.vt* file = verification table files

Directory - ftp/pub/ars/agnps/dos/version5/verified/data/output.nps - AGNPS 5.00 
								Verification Output Files

Directory - ftp/pub/ars/agnps/dos/version5/verified/data/output.vt - AGNPS 5.00 Verification 
										Tables

Directory - ftp/pub/ars/agnps/dos/version5/verified/docs - AGNPS 5.00 Verification Documents.

Directory - ftp/pub/ars/agnps/dos/version5/verified/docs/document - AGNPS 5.00 Verification 
									Documents.

Directory - ftp/pub/ars/agnps/dos/version5/verified/docs/handcalc - AGNPS 5.00 Verification
									Hand calculations
Directory - ftp/pub/ars/agnps/source/.. -  This directory contains the source code for each of
the following AGNPS version 5.00 modules.  Each module is to be compiled as a separate executable. 
Each of these executable files are then called from the main AGNPS Spreadsheet program. 
Each module is set up as a project using either Borland C version 2.0+, or Borland Pascal 
version 7.0 or above.  NOTE that AGNPS version 5.0 is a DOS program and all windowing is done
using TechnoJock's Turbo Toolkit Version 5.0.  For information on the "T-Jock" software please
contact:

        TechnoJock Software, Inc.
        PO Box 820927
        Houston, Texas 77282-0927

Memory management for the actual AGNPS model was handled by the Phar Lap Extended Memory Manager. 
For information on the Phar Lap Extended Memory Manager software please contact:

        Phar Lap Software, Inc.
        60 Aberdeen Ave.
        Cambridge, MA 02138
        (617) 661-1510

Memory management for the spreadsheet and other pascal modules was handled by Borland's DPMI memory manager
which comes with their compiler products.  Each of the modules are now listed below...

        SCIENCE----------> C
        TABULAR----------> Pascal
        GRAFIX-----------> Pascal
        SPREAD-----------> Pascal
        SRCACCNT---------> Pascal
        INSTALL----------> Pascal
        CHECK------------> C

For information about compiling instructions please see VRFSCIEN.DOC microsoft word document.


Directory - ftp/pub/ars/agnps/unix

     agrun500.out - This is the Unix version of the AGNPS model.  
		    It was compiled for a Sun LX Workstation.
     agw7.dat -       Example watershed data file.
     agw7.output -  Example watershed output file to be compared to your run 
		      output from the agw7.dat data set.
     beaver.dat -     Example watershed data file.
     beaver.output - Example watershed output file to be compared to your 
		      run output from the beaver.dat data set.
     trnsmt50.txt -  ASCII verification report letter


		 

