HARPO file documentation The following files are in this directory. readme Short documentation for HARPO. harpo.doc This file. errata Errata for the HARPO report. harp-ind Index of HARPO entry-point names. harp-mem List of subroutines, functions and their entry points. cofil1 File 1 of the distribution tape (routines for sample case). cofil2 File 2 of the distribution tape (input data for sample case). cofil3 File 3 of the distribution tape (ray-tracing core routines). cofil4 File 4 of the distribution tape (dispersion-relation routines). cofil5 File 5 of the distribution tape (ocean-model routines). cofil6 File 6 of the distribution tape (graphics-file read program). cofil7 File 7 of the distribution tape (DDSPLA). cofil8 File 8 of the distribution tape (DDALT). The distribution tape is described on page 54 of the HARPO manual. These files are identical to files 1 through 8 of the distribution tape. Further HARPO file documentation The following additional files are in this directory. (These files are used with the UPDATE utility in NOS. If you are not using the NOS operating system, you have no use for these files.) The files bdeck, outtest, and oharpo are binary files so it is necessary to "get" them in ftp binary mode. lfileo1 UPDATE directives to produce file 1 of the distribution tape. lfileo3 UPDATE directives to produce file 3 of the distribution tape. lfileo4 UPDATE directives to produce file 4 of the distribution tape. lfileo5 UPDATE directives to produce file 5 of the distribution tape. lfileo6 UPDATE directives to produce file 6 of the distribution tape. lfileo7 UPDATE directives to produce file 7 of the distribution tape. lfileo8 UPDATE directives to produce file 8 of the distribution tape. oharpo.itm Itemization of modules in the oharpo program library. pharpo Three NOS procedures to produce files for the distribution tape. pbldhrp NOS procedure file to produce image of distribution tape. ptapeio NOS procedure file to produce the distribution tape. sharpo Input file to produce the oharpo CDC UPDATE program library. fdeck FORTRAN source program for bdeck bdeck CYBER 840 program to make the HARPO program files more readable. outtest (binary file) oharpo Program library (as defined in the CDC UPDATE environment). These files can be used to generate a HARPO distribution tape by following the instructions below. These instructions apply to the CDC CYBER 840 with the NOS operating system in Boulder, but other CDC computers are probably similar. OHARPO is the program library (as defined in the CDC UPDATE environment). The files LFILEO1 through LFILEO8 contain UPDATE directives to produce the files of the distribution tape from OHARPO. The file PHARPO contains 3 procedures to help do that. These procedures now expect all of the relevant files to be in the JPR account, but that could be changed. The first procedure is used by typing the following: -PGENFLS,PHARPO This invokes the UPDATE procedure to make files COFILE1, COFILE3, COFILE4, COFILE5, COFILE6, COFILE7, AND COFILE8 that are FORTRAN compilable files that contain the subprograms listed in the corresponding L files. It also runs the program BDECK, that produces corresponding files COFIL1 through COFIL8, that have 5 blank lines between adjacent subprograms, and have line numbers incremented by 10 instead of by 1. The file FDECK is the FORTRAN source program for BDECK. The files COFIL1 through COFIL8 produced differ from those on the distribution tape in that the subprogram identification in card columns 73 through 76 are slightly different. The next procedure is invoked by typing -STO,PHARPO This stores the files created in the permanent directory. The next procedure is invoked by typing -PBLDHRP,PHARPO This produces a local file, HARPOTP, that is the same as the distribution tape we have been sending out, except that the subprogram identification in columns 73 through 76 often differs, and tape file 9 (SHARPO described below) in the original distribution tape seems to be missing a line somewhere. This produces a HARPOTP that is 3083 PRUs and has 31952 lines. The original was 3083 PRUs and had 31951 lines. Apparently, the 9th file in the original HARPOTP was missing one line. HARPOTP made by the above procedure can be made permanent by typing -PUTFIL,,HARPOTP This procedure also produces a local file SHARPO (use PUTFIL to make it permanent), that can be used to make a program library. This is done by typing UPDATE,I=SHARPO,N=OHARPO This produces a new program library, OHARPO, that I think is equivalent to OHARPO that we now have, although it may not be identical to the last bit. To write HARPOTP to a tape type -HRPOWT,PTAPEIO,VSN=B,A SUBMIT,TJOB The default for B is "V01677", the default for A is "Y". Make sure you have the correct VSN number before you submit the job, or you may clobber someone else's tape. I have not actually tried producing a tape. I have just read the instructions.