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
     system  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.1 of VAX LIST has  some  improvements  in  the  way  it
     handles  file  names and logical names.  In particular, a colon is not
     needed on a logical name for it to be recognized as  a  logical  name.
     In  addition,  LIST  handles  network  file  and  task  specifications
     correctly now.

          Version 3 of LIST has some notable  improvements  over  the  last
     release.   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,
     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
     different  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
     included 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.
                                                                     Page 2


     To build LIST for VAX VMS, say

     @BUILD

     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
     substitute  the  object code produced by RUNSYMU.FTN for that produced
     by RUNSYSIAS.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