




                           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 a screen
     at a time.  It has sophisticated string searching and  can  write  out
     portions  of  files  to other files.  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,  and  can list VAX RMS indexed files by key number and do key
     searches.

          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 lines in the file to simulate random access on the file.

          Version 3 of LIST has some notable improvements over the last re-
     lease.   The search routines have been recoded in macro for speed, and
     some nice command line switches have been added, including several for
     specifying  key  number  and key searches when listing VAX RMS indexed
     and relative files.  Also, a comprehensive help file is  included  for
     VAX VMS.

          LIST is available for VAX VMS systems and RSX/IAS  systems.   The
     VAX  VMS version runs in native mode.  There is a help file, LIST.HLP,
     for VAX VMS, and a comprehensive user manual, LIST.DOC, is included in
     both distributions.  The VAX help file should be placed in your system
     help library.  The VAX VMS version also includes a command file,  MAK-
     ELIST.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.

          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 is 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



                                                                     Page 2



     To build LIST for IAS, say

     @IASBUILD

     To build LIST for RSX-11M, say

     @RSXBUILD

     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



