




                           LIST File Listing Utility
                           =========================





          LIST is like the TYPE and Unix GREP commands only better.  LIST's
     simplest  use is to display lines from a file at the terminal, usually
     a screen at a time.  It has sophisticated  string  searching  and  can
     write out portions of files to disk.  File names to be listed may have
     wild card characters in them, making it easy  to  do  such  chores  as
     looking  through a group of files for a particular string or variable.
     Finally, LIST can be positioned randomly in a file using line (record)
     numbers.

          LIST is very fast, as it uses a macro interface to the file  sys-
     tem  to read and write files;  in addition it buffers the disk address
     of every 100 lines to simulate random access on the file.

          LIST is available for VAX VMS systems and RSX/IAS  systems.   The
     VAX  VMS  version  runs in native mode.  There is no help file for VAX
     VMS yet, however a comprehensive user manual, LIST.DOC, is included in
     both distributions.  The VAX VMS version also includes a command file,
     MAKELIST.COM, which uses LIST to rewrite a carriagecontrol  NONE  file
     as  a carriagecontrol LIST file, and a command file, SEARCH.COM, which
     uses LIST to search through files for a given string.

          On RSX/IAS systems, SRD is used to select wild card  file  names.
     The  routine  which gets file names from SRD is called FNDFIL.FTN;  if
     for some reason SRD doesn't work with LIST (if your SRD has a  differ-
     ent  output  file  format from our SRD, for instance) then modify this
     file.  If you would rather use PIP than SRD, there is  a  file  called
     PIPFIL.RAT (and also PIPFIL.FTN) which contains the FNDFIL subroutine,
     but for PIP.  A help file is included (LIST.HLP) and should be  placed
     on LB:[1,2].

          LIST is written almost entirely in Ratfiv;  on  RSX/IAS  systems,
     the  .FTN  files are included, however the Ratfiv compiler is also in-
     cluded on this tape, and should be very simple to build.  On  VAX  VMS
     systems, LIST's .EXE file is included, as is the Ratfiv source and the
     Ratfiv compiler.

     To build LIST for VAX VMS, say

     @BUILD

     To build LIST for IAS, say

     @IASBUILD

     To build LIST for RSX-11M, say

     @RSXBUILD



                                                                     Page 2



     To build LIST for IAS multi-user systems use IASBUILD.CMD, but substi-
     tute the object code produced by RUNSYMU.FTN for that produced by RUN-
     SYSIAS.MAC in the file IASTKB.CMD.

     Send comments, problems, etc.  to:

            William P. Wood, Jr.
            Computer Center
            Intstitute For Cancer Research
            7701 Burholme Ave.
            Philadelphia, PA. 19111
            (215) 728 2760



