COMPUTATION--Availability of hydraulics programs for Prime computers

In Reply Refer To:                                        September 9, 1983
EGS-Mail Stop 415




SURFACE WATER BRANCH TECHNICAL MEMORANDUM NO. 83.07

Subject:  COMPUTATION--Availability of hydraulics programs for Prime computers

Three hydraulic analysis programs maintained by the Surface Water Branch in
the Watstore program library have been converted to run on the Prime computers
of the Water Resources Division's Distributed Information System (DIS).  In
addition, a widely used but unofficial program for plotting open-channel
cross sections for step-backwater studies has been converted and also extended
to plot cross sections for the slope-area and culvert-rating programs.  The
programs are identified as follows:

     A526     SWCULRAT     Stage-discharge relations at culverts

     C374     SWSLOPE      Slope-area discharge determination

     E431     SWBWFA       Step-backwater and floodway analysis

     J754     SWPLOTXS     Cross-section plots
              (in SWB. PROCLIB)

The converted programs use the same input formats, follow the same processing
logic, and produce the same outputs as the versions in the Watstore library.
Current instructions for input data preparation remain in effect.  Data sets
that have run on the Amdahl should yield essentially identical results on the
Prime.

Until the DIS communications network becomes operational, copies of these
programs may be obtained by running the following job on the USGS Re-1 Amdahl
computer:

     //----  JOB  ----

     /*JOBPARM   C=800,L=5

     /*ROUTE   PUNCH   RMTnnn

     //PROCLIB   DD   DISP=SHR,DSN=SWB.PROCLIB

     //   EXEC   CARDPCH,UDS='SWB.xxx.TRANSFER/'




in which xxx should be replaced by the appropriate program number--A526,
C374, E431, or J7540--and nnn should be replaced by the Amdahl remote-terminal
number of the Prime site.  This job sends punched-card images to the Prime
RJE facility at the specified site.  The cards alternatively could be sent
by means of TSO or WYLBUR.  Installation-specific procedures should be
followed to receive the card images and move them to an appropriate user
directory.  The card images include the Fortran 77 source code, a test data
set, and a set of Prime CPL commands that can be used to load and test the
program.  More detailed instructions are contained in the first few card
images of each deck.  After the first few lines have been edited out, the
remainder of the deck can be run as a single Prime CPL program that automati-
cally will create all files, compile the program, and run the test job.

We strongly urge that a separate User File Directory (UFD) be set up with the
name SWB to hold these programs and any other programs provided by the Surface
Water Branch.  All users should have List-Use-Read access to this directory.
By this means, users will be able to prepare input data sets in their own
directories and execute the programs by means of commands of the following
form:

     CPL   SWB>xxx   incards   printout

in which xxx is the program number, incards is the name of the user's input-
card file, and printout is the name of the user's file that is to receive the
printed output.  (If the printout argument is omitted, the output will be
spooled directly to the printer.)  The programs also can be run with the
PHANTOM or JOB commands in the same way.

The following guidelines for use of these programs should be observed until
further notice.  The programs as distributed should compile, load, and execute
without error.  If any problems are encountered in compiling, loading, or
running these programs, please contact William Kirby, Surface Water Branch,
FTS 928-6804.  (Questions about hydraulic methodology and input data preparation
should continue to be directed to District and Regional Surface Water
Specialists).  Please do not attempt to debug, correct, or improve any of
these programs yourself--someone else may already be working on the problem.
Instead, contact the Surface Water Branch.  Similarly, please do not give
machine-readable copies (printouts are acceptable) to third parties, including
cooperators: contact Surface Water Branch first for information on updates or
conversions to non-Prime computers.

The surface-water hydraulics specialists and system administrators at all
Prime DIS installation are requested to make arrangements to retrieve, load,
and test these programs in a UFD named SWB.  Again, please report any problems
to William Kirby, FTS 928-6804.  Further information about any revisions of
these programs and release of new programs will be disseminated as necessary.



                                           Marshall E. Moss

Distribution: A, B, FO, PO