.PAGE SIZE 60,75
.header mixed
.LM +5
.RM 75
.HY
.skip 20
.center
LIST File Listing Utility
.center
=========================
.skip 4
.autoparagraph
 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 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.
.skip 1
To build LIST for VAX VMS, say
.skip 1
@BUILD
.SKIP 1
^T\\O BUILD ^^LIST\\ FOR ^^IAS\\, SAY
.SKIP 1
^^@IASBUILD\\
.SKIP 1
^T\\O BUILD ^^LIST\\ FOR ^^RSX-11M\\, SAY
.SKIP 1
^^@RSXBUILD\\
.SKIP 1
^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\\.
.SKIP 1
^SEND COMMENTS, PROBLEMS, ETC. TO:
.SKIP 1
.LM +7
.NOFILL
^WILLIAM ^P. ^WOOD, ^JR.
^COMPUTER ^CENTER
^INTSTITUTE ^FOR ^CANCER ^RESEARCH
7701 ^BURHOLME ^AVE.
^PHILADELPHIA, ^P^A. 19111
(215) 728 2760
