T00101
----------------------------------------------------------------------------- 
RCP                                                                      T001 
                            RCP INTERFACE TO FTP
----------------------------------------------------------------------------- 
  
 Contribution Name...........: RCP
    Title....................: RCP Interface to FTP 
    File Names...............:00. Rename Transfer File (Interex supplied) 
                             :01. RCP.SBMT
                             :02. RCP.C 
                             :03. RCP.REL 
                             :04. RCP.LOD 
                             :05. RCP.HLP 
    Operating System.........: RTE-A
    Language(s)..............: C
    Keywords.................: 1. NETWORK 
                             : 2. COPY
                             : 3. FILE_TRANSFER 
    External Support Req'd...: $CCSC.LIB (N023) or HPC.LIB
    If Re-submission, Reason.:
 Contributor's Name..........: David A. Boskey
               Company.......: Corporate Computer Systems, Inc. 
               Street........: 33 West Main Street
               City..........: Holmdel
               State.........: New Jersey 
               Country.......: USA
               Zip Code......: 07733
               Phone Number..: (908) 946-3800 
               Fax...........: (908) 946-7167 
 Contribution Abstract.......:
   This contribution contains a  program which provides an rcp- 
   like interface  to  the FTP facility available with NS/1000. 
   It will build a command file with the necessary commands for 
   FTP to transfer a  single file to or from a remote computer. 
   It can  be  run with one of the following commands depending 
   on the direction of the file transfer: 
  
        rcp [-b] user[$pass]@node:src_fn dest_fn
        rcp [-b] src_fn user[$pass]@node:dest_fn
  
   The -b option can be used to specify  that the transfer will 
   be performed in binary mode. 
  
 Additional Documentation....:
  
T00201
----------------------------------------------------------------------------- 
ENTRIES                                                                  T002 
                  REPORT RTE-A OPERATING SYSTEM PROPERTIES
----------------------------------------------------------------------------- 
  
 Contribution Name...........: ENTRIES
    Title....................: Report RTE-A Operating System Properties 
    File Names...............: 00. Rename Transfer File 
                             : 01. ENTRIES.SBMT This file 
                             : 02. ENTRIES.FTN  Source
                             : 03. ENTRIES.LOD
                             : 04. ENTRIES.MAKE Compile/link commands 
                             : 05. ENTRIES.REL
                             : 06. ENTRIES.SEND File list for KERMIT send 
                             : 07. CPU.MAC      Macro source
                             : 08. CPU.REL      Macro relocatable 
    Operating System(s)......: RTE-A
    Uses hierarchical files?.: No 
    Language(s)..............: FTN7X,MACRO
    Keywords.................: COMMON 
                             : ENTRY_POINTS 
                             : SYSTEM 
    External Support Req'd...: None 
    If Re-submission, Reason.: Enhancements 
 Contributor's Name..........: Donald A. Wright 
               Company.......: Interactive Computer Technology
               Street........: 2069 Lake Elmo Avenue North
               City..........: Lake Elmo
               State.........: MN 
               Country.......: USA
               Zip Code......: 55042
               Phone Number..: 612/770-3728 
               Fax Number....: 612/770-5986 
               Date..........: 93 Mar 20
 Program Abstract............:
  
 ENTRIES is a quick and dirty program that reports back the  operating
 system $OPSY code, the date code $DATC, firmware revision $FREV, size
 of blank common $BC#, and CPU type (i.e. A400, A990).
  
 It's  especially handy for folks who ship software to sites where the
 exact CPU and operating system  may  be  unknown,  e.g.  vendors  and
 internal  software  support  personnel.  It can be shipped along with
 other software, and quickly linked and run if there is a need to know
 any of the items that it reports.
  
 We ship it now with CONNECT and SYLOG, so that if there are  problems
 and we need to dial in we can immediately determine what we are deal-
 ing with.
  
 This version is enhanced over a previous submission on the 1991  swap
 tape  and on the 3226 CSL tape.  It includes the A990 and a much bet-
 ter report of the .FREV value(s), which no longer worked correctly in
 the previous submission on RTE Rev 6000. 
  Sept. 15,1993   Don Clapp:   Now returns these values so that a CI
 script can determine the CPU type etc. 
  
 Here is a typical report on an A400: 
  
    CI> entries 
     $OPSY  Operating System  =  -125 
     $DATC  OPSY Date Code    =  6000 
     $BC#   Blank Common Size =  5267 
     .CPUID CPU Type          =  7    A400
     .FREV  CPU Control Store =  Bank 0  Rev 12  Package= 1  Base Set 
     .FREV  CPU Control Store =  Bank 1  Rev 12  Package= 1  Base Set 
     .FREV  CPU Control Store =  Bank 2  Rev 12  Package= 1  Base Set 
     .FREV  CPU Control Store =  Bank 3  Rev 12  Package= 1  Base Set 
    CI> 
  
 Note: At RTE Rev 6000, the OPSY and DATC values are also  displayable
 with  CI's SET command.  However, this program should link and run on
 almost ANY revision of RTE.
  
  
 Additional Documentation....:
  
T00301
----------------------------------------------------------------------------- 
ADJTIME                                                                  T003 
                        SET SYSTEM TIME FROM NETWORK
----------------------------------------------------------------------------- 
  
 Contribution Name...........: ADJTIME
    Title....................: Set system time from network 
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. ADJTIME.SBMT
                             :02. ADJTIME.C 
                             :03. ADJTIME.REL 
                             :04. ADJTIME.LOD 
                             :05. MAKEFILE
    Operating System(s)......: RTE-A & UNIX 
    Language(s)..............: C
    Keywords.................: 1. TIME
                             : 2. SYSTEM
                             : 3. UNIX
                             : 4. NETWORK 
    External Support Req'd...: NS & TIME server 
    If Re-submission, Reason.:
 Contributor's Name..........: Donald L. Clapp
               Company.......: Eli Lilly & Co.
               Street........: Lilly Corporate Center 
               City..........: Indianapolis 
               State.........: Indiana
               Country.......: USA
               Zip Code......: 46285
               Phone Number..: (317) 276-1207 
               Internet......: CLAPP@LILLY.COM
 Contribution Abstract.......:  This program uses socket code to
 ask for the time across a network.   The server is a standard Network
 Time Protocol (NTP).    This one source provides the code for BOTH 
 RTE-A and UNIX by a compile time option. 
 Additional Documentation....:  See the source. 
  
T00401
----------------------------------------------------------------------------- 
SKD_DBSAVE                                                               T004 
               SAVE AN IMAGE/1000-I DATA BASE IN DBBLD FORMAT 
----------------------------------------------------------------------------- 
  
 Contribution Name...........: SKD_DBSAVE 
    Title....................: Save an IMAGE/1000-I Data Base in DBBLD Format 
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. SKD_DBSAVE.SBMT 
                             :02. SKD_DBSAVE.FTN
                             :03. SKD_DBSAVE.REL
                             :04. SKD_DBSAVE_SUBS.FTN 
                             :05. SKD_DBSAVE_SUBS.REL 
                             :06. SKD_DBSAVE.DOC
                             :07. SKD_DBSAVE.LOD
                             :08. SKD_DBSAVE.FTNI 
    Operating System(s)......: RTE-A, RTE-6(Not tested) 
    Language(s)..............: Fortran 77 
    Keywords.................: 1. IMAGE 
                             : 2. DATA BASE 
                             : 3. BACKUP
    External Support Req'd...:  IMAGE(92069)
    If Re-submission, Reason.: Small extensions.
 Contributor's Name..........: Donald L. Clapp
               Company.......: Eli Lilly & Co.
               Street........: 307 E. McCarty St. 
               City..........: Indianapolis 
               State.........: Indiana
               Country.......: USA
               Zip Code......: 46285
               Phone Number..: (317) 276-1207 
               Internet......: Clapp@Lilly.com
 Contribution Abstract.......:    This program will save an IMAGE 
 Data Base( or a set) to a file in the format that DBBLD expects. 
 This file could then be EDITed before using DBBLD to add the 
 records to a data base.
   Originated on the Detroit Swap Tape (1986) as D089-- and 
 CSL-1000  Release 2730.  I have used it and it works for me. 
 Richard E. Alm & Lew Mtezger are to be congratulated on good work. 
 Additional Documentation....:  See SKD_DBSAVE.DOC
  
T00501
----------------------------------------------------------------------------- 
LP                                                                       T005 
                       SPOOL THROUGH UNIX TO LASERJET 
----------------------------------------------------------------------------- 
  
 Contribution Name...........: LP 
    Title....................: Spool through UNIX to Laserjet 
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. LP.SBMT 
                             :02. LP        Help file 
                             :03. FTP.CMD   FTP prototype 
                             :04. LP1S.CMD  Command for 1 up,1 side 
                             :05. LP2S.CMD    2 up, 1 side
                             :06. LP4S.CMD    4 up, 1 side
                             :07. LP1D.CMD    1 up, 2 sides 
                             :08. LP2D.CMD    2 up, 2 sides 
                             :09. LP4D.CMD    4 up, 2 sides 
                             :10.  PRINT_FILE    UNIX SCRIPT
                             :11.  SWEEP_PRINT   UNIX SCRIPT
                             :12.  CRON.DAT      UNIX SCRIPT
                             :13.  LP.DOC 
    Operating System(s)......: RTE-A & HP-UX
    Language(s)..............: CI & Shell scripts 
    Keywords.................: 1. Spooling
                             : 2. Network 
                             : 3. File transfer 
                             : 4. Laserjet
                             : 5. Printer 
    External Support Req'd...: NS  (FTP)
    If Re-submission, Reason.:
 Contributor's Name..........: Donald L. Clapp
               Company.......: Eli Lilly & Co.
               Street........: Lilly Corporate Center 
               City..........: Indianapolis 
               State.........: Indiana
               Country.......: USA
               Zip Code......: 46285
               Phone Number..: (317) 276-1207 
               Internet......: CLAPP@LILLY.COM
 Contribution Abstract.......:  These scripts provide for printing
to a network attached Laserjet from a HP1000.  It does take some
cooperation with a UNIX system.  The files are copied to the UNIX 
system and then it sends the file to the printer.  Rumor has it that
with Rev. 6.1 of RTE-A the 1000 will be able to send the file directly
to a network printer. 
 Additional Documentation....:  See LP & LP.DOC 
  
T00601
----------------------------------------------------------------------------- 
FORM                                                                     T006 
                               FORMS GENERATOR
----------------------------------------------------------------------------- 
  
 Contribution Name...........: FORM 
    Title....................: FORMS GENERATOR
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. FORM.SBMT 
                             :02. FORM.FTN
                             :03. FORM.REL
                             :04. FORM.HLP
                             :05. FORM_STD.LOD
                             :06. FORM_CDS.LOD
                             :07. ASMSC_CDS.FTN 
                             :08. ASMSC_CDS.REL 
                             :09. ASMSC_STD.FTN 
                             :10. ASMSC_STD.REL 
                             :11. ASMTB.FTN 
                             :12. ASMTB.REL 
                             :13. UTLB.LIB
                             :14. FORM1.SCN 
                             :15. FORM2.SCN 
                             :16. FORM3.SCN 
                             :17. FORM1.MAC 
                             :18. FORM1.rel 
    Operating System(s)......:  RTE_A  (any)
    Language(s)..............: FTN7X, MACRO 
    Keywords.................: 1. FORMS 
    External Support Req'd...:
    If Re-submission, Reason.: ENHANCEMENTS 
 Contributor's Name..........: Donald L. Clapp
               Company.......: Eli Lilly & Co.
               Street........: Lilly Corporate Center 
               City..........: Indianapolis 
               State.........: Indiana
               Country.......: USA
               Zip Code......: 46285
               Phone Number..: (317) 276-1207 
               INTERNET......: CLAPP@LILLY.COM
 Contribution Abstract.......:  Originally on CSL 2830. 
This program produces the MACRO source to display a form on a crt.
The screen code now can be either STD or CDS.   Some of the scheduling
parameters were also changed.    Currently , there are two versions of
the program depending on the output wanted (STD or CDS).   I may get
around to making that a parameter in the main program sometime. 
The program now schedules MACRO if the output file has a .MAC extension.
 Additional Documentation....: FORM.HLP 
  
T00701
----------------------------------------------------------------------------- 
DLOPL                                                                    T007 
                     DIRECTORY LIST ONE PROGRAM PER LINE
----------------------------------------------------------------------------- 
  
 Contribution Name...........: DLOPL
    Title....................: Directory List One Program per Line
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. DLOPL.SBMT
                             :02. DLOPL.CMD 
                             :03. DLOPL.HLP (copy to /help/dlopl) 
    Operating System(s)......: RTE-A or RTE-6 
    Language(s)..............: CI script
    Keywords.................: 1. DIRECTORY 
                             : 2. COMMAND_FILES 
    External Support Req'd...: CI and EDIT
    If Re-submission, Reason.:
 Contributor's Name..........: Donald L. Clapp
               Company.......: Eli Lilly & Co.
               Street........: Lilly Corporate Center 
               City..........: Indianapolis 
               State.........: Indiana
               Country.......: USA
               Zip Code......: 46285
               Phone Number..: (317) 276-1207 
               Internet......: CLAPP@LILLY.COM
 Contribution Abstract.......: This script produces a directory list
in a file with one entry per line.  The header and trailer are striped
off.  The file extension can be removed.
 Additional Documentation....:
  
T00801
----------------------------------------------------------------------------- 
STRING                                                                   T008 
                         STRING LIBRARY - LIKE DECAR
----------------------------------------------------------------------------- 
  
 Contribution Name...........: STRING 
    Title....................: STRING LIBRARY - LIKE DECAR
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. STRING.SBMT 
                             :02. STRING.MAC
                             :03. VHPGL_A.MAC 
                             :04. HEX.MAC 
                             :05. HEX_TEST.FTN
                             :06. V_TEST.FTN
    Operating System(s)......: RTE-A (ANY REV)
    Language(s)..............: MACRO,FTN
    Keywords.................: 1. LIBRARY 
                             : 2. STRINGS 
    External Support Req'd...:
    If Re-submission, Reason.: ENHANCEMENTS 
 Contributor's Name..........: Donald L. Clapp
               Company.......: Eli Lilly & Co.
               Street........: Lilly Corporate Center 
               City..........: Indianapolis 
               State.........: Indiana
               Country.......: USA
               Zip Code......: 46285
               Phone Number..: (317) 276-1207 
               Internet......: CLAPP@LILLY.COM
 Contribution Abstract.......:  This package implements some of the 
 string functions like those found in the DECAR library.   The changes
 were to provide A source that would compile into either STD or CDS.
 Two other subroutines are also included,  VHPGL and HEX.  The routine
 VHPGL will take an array of integers as input and produce a buffer 
 output with the numbers in text seperated with commas.  Can be used
 to output data to a plotter.   The routine HEX converts a word into
 the proper hex characters. 
 Additional Documentation....:  See the code. 
  
T00901
----------------------------------------------------------------------------- 
ALL_DIR_OWNERS                                                           T009 
                       LIST OWNER'S OF ALL DIRECTORIES
----------------------------------------------------------------------------- 
  
 Contribution Name...........: ALL_DIR_OWNERS 
    Title....................: List Owner's of All Directories
    File Names...............:00. Rename Transfer File (Interex supplied) 
                             :01. ALL_DIR_OWNERS.SBMT - This file 
                             :02. ALL_DIR_OWNERS.CMD  - Full report 
                             :03. SUB_DIR_OWNERS.CMD  - Partial report
                             :04. DIR_OWNERS.EDT1     - Edit command file #1
                             :05. DIR_OWNERS.EDT2     - Edit command file #2
                             :06. ALL_DIR_OWNERS.DAT  - Sample output file
                             :07. HP6P0.OWNR          - Sample output file
    Operating System.........: RTE-A (5.1 up) 
    Language(s)..............: CI, EDIT and MERGE commands
    Keywords.................: 1. DIRECTORY 
                             : 2. REPORTS 
                             : 3. TOOLS 
    External Support Req'd...: None 
    If Re-submission, Reason.:
 Contributor's Name..........: Douglas F. Hawkland, III 
               Company.......: Westinghouse ESG 
               Street........: PO Box 1897    MS: W70 
               City..........: Baltimore
               State.........: Maryland 
               Country.......: U.S.A. 
               Zip Code......: 21203
               Phone Number..: 410-993-2064 
 Contribution Abstract.......: Generate a list of owners of all directories.
      By using CI and edit, command files are created that display, capture,
      and save the owners of each top level directory and their sub-
      directories. These saved files are merged together and formated to
      create the report in file 'ALL_DIR_OWNERS.DAT'. 
          A report for a single top level directory may be generated by 
      using the 'sub_dir_owners.cmd' command file. For example, 
      'tr,sub_dir_owners.cmd,hawkland' will display the owner of /hawkland
      and the owner's of all sub-directories under /hawkland. 
  
      NOTE: For the files to execute properly:
            - all four files must be in the current working directory.
            - the user must be a superuser if any of the directories
              are read protected from the user. 
  
      WARNING: Several temporary files are created that are cleaned up
               using a wildcard purge. You should check the "clean up"
               section of both command files to make sure none of your
               files will be purged.
  
 Additional Documentation....: See the comments in the command files. 
  
  
T01001
----------------------------------------------------------------------------- 
R_CLIENT                                                                 T010 
                     PROVIDE BSD IPC CLIENT-SERVER PAIR 
----------------------------------------------------------------------------- 
  
 Contribution Name...........: R_CLIENT 
    Title....................: Provide BSD IPC client-server pair 
    File Names...............:00. Rename Transfer File
                             :01. R_CLIENT.SBMT 
                             :02. INSTALL.CMD       Installation file 
                             :03. R_CLIENT.DOC      Documentation 
                             :04. R_CLIENT.FTN      Main client program 
                             :05. R_CLIENT.REL      Main relocatable
                             :06. R_CLIENT.LOD      Link command file 
                             :07. R_CLIENT.CF    Example /etc file
                             :08. R_SERVER.FTN      Main server program 
                             :09. R_SERVER.REL      Main server relocat 
                             :10. R_SERVER.LOD      Main server load
                             :11. R_SERCLIENT.TAR     TAR file for HPUX end 
                             :12. to_user.hlp      to_user help file
                             :13. MS.FTN           Message display program
                             :14. MS.REL           Message display reloc
                             :15. BC.FTN           Message display program
                             :16. BC.REL           Message display reloc
                             :17. BC.LOD           Message display load file
                             :18. BC.HLP           BC help file 
    Operating System.........: RTE-A
    Uses hierarchical files?.: yes
    Language(s)..............: Fortran, C (files for HP-UX only)
    Keywords.................: 1. system
                             : 2. network 
                             : 3. system
    External Support Req'd...: BSD IPC
    If Re-submission, Reason.:
 Contributor's Name..........: F. Stephen Gauss 
               Company.......: U.S. Naval Observatory 
               Street........: 3450 Massachusetts Ave. NW 
               City..........: Washington 
               State.........: DC 
               Country.......: USA
               Zip Code......: 20392-5400 
               Phone Number..: 202-653-1510 
                             : Internet: fsg@sicon.usno.navy.mil
  
 Program Abstract............: r_client and r_server run on RTE-A,
r_sercli.tar contains the equivalent files to run on
HP-UX.  This allows the 1000 to display information from the HP-UX
system.  The services are provided using Berkeley Sockets.  Commands that 
can be given on the 1000 include nslookup, man and bdf. 
 In addition messages can be sent between RTE and HP-UX using to_user,
which has client and server modules for both RTE and HP-UX. 
 The contribution, bc, by Jon Wetherbee from CSL 2930 is included here
and is used by to_user. 
  
 Additional Documentation....: see r_client.doc 
See also my submission of whozn which operates in a similar fashion and 
displays who is logged on.
  
  
T01101
----------------------------------------------------------------------------- 
FAST                                                                     T011 
                         FAST STRING SEARCH OF FILE 
----------------------------------------------------------------------------- 
  
 Contribution Name...........: FAST 
    Title....................: Fast string search of file 
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. FAST.SBMT 
                             :02. FAST.FTN
                             :03. FAST.REL
                             :04. FAST.LOD
                             :05. FAST.MK 
                             :06. FAST.HLP
    Operating System(s)......: RTE-A/6
    Language(s)..............: FORTRAN 77 
    Keywords.................: 1. Files 
                             : 2. Search
                             : 3. Strings 
    External Support Req'd...:
    If Re-submission, Reason.:
 Contributor's Name..........: John L. Anderson Jr. 
               Company.......: Naval Warfare Assessment Center
               Street........: Box 5000, MS-12
               City..........: Corona 
               State.........: CA 
               Country.......: USA
               Zip Code......: 91781-5000 
               Phone Number..: (909) 273-4719 
 Contribution Abstract.......:
  
    This program will search files specified in a mask for a given string.
 If the string is found, the approximate character position from the
 beginning of the file is displayed after the file name.  Case folding may
 also be used.  All file are treated as type one files.  The program runs 
 very fast and gives a list of all files that contain the string.  The
 program is intended for large global searches to localize an area for
 use with GREP or FINDS to find the actual strings. 
  
 Example: finds test @.ftn case 
  
 This searchs all FORTRAN source code in the working directory for the
 string 'TEST'.  All source lines are shifted to upper case before comparing. 
  
 Additional Documentation....:
  
 Warning: This program will match strings that occur beyond the normal
          EOF or possible length words since it looks at the entire file
          file in binary.  Use the editor to find out if a string really
          exists. 
  
T01201
----------------------------------------------------------------------------- 
BCMP                                                                     T012 
                           COMPARE BASIC PROGRAMS 
----------------------------------------------------------------------------- 
  
 Contribution Name...........: BCMP 
    Title....................: Compare BASIC Programs 
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. BCMP.SBMT 
                             :02. BCMP.FTN
                             :03. BCMP.REL
                             :04. BCMP.LOD
                             :05. BCMP.MK 
                             :06. BCMP.HLP
    Operating System(s)......: RTE-A/6
    Language(s)..............: FORTRAN 77 
    Keywords.................: 1. BASIC 
                             : 2. Files 
                             : 3. Compare 
    External Support Req'd...:
    If Re-submission, Reason.:
 Contributor's Name..........: John L. Anderson Jr. 
               Company.......: Naval Warfare Assessment Center
               Street........: Box 5000, MS-12
               City..........: Corona 
               State.........: CA 
               Country.......: USA
               Zip Code......: 91718-5000 
               Phone Number..: (909) 273-4719 
 Contribution Abstract.......:
  
   This program compares two BASIC programs based on the statement numbers. 
 A group of files can be checked using a file mask for different directories. 
 A summary printout of lines changed, added and deleted is printed out. 
 Special checks are made for differences of only trailing blanks. 
  
 Example: 
  
   Compare 'A' version of 0698 on CRN 7 with 'B' version on CRN 41
  
     BCMP,A0698@::7,B@::41,6
  
 Additional Documentation....:
  
    This program was developed for use with BASIC/1000D.  For other BASICS
 without lines numbers, use SCOM instead.  Renumbering makes comparisions 
 meaningless. 
  
T01301
----------------------------------------------------------------------------- 
PARSE                                                                    T013 
                      PARSE SUBSTRINGS/PARAMETERS/LINES 
----------------------------------------------------------------------------- 
  
 Contribution Name...........:PARSE 
    Title....................:PARSE Substrings/Parameters/Lines 
    File Names...............:00. Rename Transfer File (Interex-supplied) 
                             :01. PARSE.SBMT
                             :02. PARSE.FTN 
                             :03. PARSE.REL 
                             :04. PARSE.LOD 
                             :05. MAKEFILE.MAKE 
    Operating System(s)......: RTE-A 6.1
    Language(s)..............: FTN7X
    Keywords.................: 1. COMMAND_FILES 
                             : 2. PARSE 
                             : 3. STRINGS 
                             : 4. FILES 
    External Support Req'd...:
    If Re-submission, Reason.:
 Contributor's Name..........: Larry Ridgley
               Company.......: Hewlett-Packard, 1BS-C 
               Street........: 1412 Fountaingrove Parkway 
               City..........: Santa Rosa 
               State.........: CA 
               Country.......: USA
               Zip Code......: 95403
               Phone Number..: (707) 577-2155 
               Fax Number....: (707) 577-4771 
 Contribution Abstract.......: This program enables one to parse a string 
      and retrieve a selectable portion thereof.  It can also parse a 
      specified line number from a type 3 or 4 text file.  The parsed item
      is returned in $RETURN_S. 
  
      Usage:  RU PARSE [-c# [-s#|-e#]] | [-p# [-d?]] | [-fn -l#] `string` 
      Where:      -c  =# of characters to parse from `string` 
                  -s  =Starting character position in `string`
                  -e  =Ending character position in `string`
         or:      -p  =Parameter number in string (space or comma delimited)
                  -d  =Alternate parameter delimiter (single character) 
         or:      -f  =File 'n' to retrieve a line from 
                  -l  =Line number in text file to retrieve 
      Returns:    $RETURN_S =The parsed substring/parameter/line
                  $RETURN1  =0 if parse successful; else <0 if error. 
                                    1 
      Examples:            123456789012345
          PARSE -c4 -s6   `This is a test.` 
          $RETURN_S = is a
  
          PARSE -s11 -e14 `This is a test.` 
          $RETURN_S = test
  
          SET fname = SNAP.SNP::SYSTEM
          PARSE -p1 -d: $fname
          $RETURN_S = SNAP.SNP
  
          PARSE -fPARSE.FTN -l1 
          $RETURN_S = FTN7X 
  
 Additional Documentation....: See source code.