Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444

Title: LIST
Author: Robin Miller
Date: December 3, 1982

Description:

The LIST program is used to list file(s) at the terminal. It lists
one screen full at a time so you can easily scroll through the file. On the
VT52, VT100, and Tektronix scope, it keeps the file name and creation date at
the top op the screen. Typing a /HE to the LIS> prompt displays the valid
switches. Typing "HELP" or question mark ("?") while listing a file displays
help on additional commands.

Operating procedures:

>LIST file_name

Where:
The file_name may be any legal VAX/RSX-11M file specification,
and may have wildcards (*) for the file names. If wildcards
are used, the version number also defaults to * automatically.

Wildcard listing on the VAX is available by using a command file
called LIST.COM. To use this command file, define the following
symbol in your login command file "LIST :== @LIST.COM". This
command procedure will probably need modified for your installation.

Examples:
*.MAC *.* TEST.* file.ext

******************************************************************************

There have been several changes made to the LIST program.

1. First, LIST presumes you are running on a VT100 with the Advanced
Video Option (AVO). If your VT100 doesn't have the AVO, you must
specify /VT or the VT command within LIST. This is only needed
if you are listing in 132 column mode. The AVO, adds an additional
10 lines of 132 column lines for display; otherwise only 14 lines
can be displayed.

2. The Find Next (FN) command has been added to search for a previous
search string. The Find command now always prompts for a search
string where previously it would use the previous search string
if there was one.

3. The most important change and the most requested, is the keypad on
the VT100 is now enabled. The PF2 key can be used to display the
keypad help just like EDT. Only those keys which make sense are
enabled. For example, FILL, WORD, EOL, CHAR, etc., are all disabled.

The arrow keys are also enabled. The right and left arrow keys are
used to move the margin left or right, and the up and down arrow
keys are used to backup or advance 1 line.

I'm open to suggestions as to how the undefined keys should be defined.
Some of the commands which could be used for these keys are:

SEEALL, RULER, NARROW, and WIDE.

******************************************************************************

The PRINT command has been added to the LIST program. The command can
be issued either by typing "PR(int)" to the prompt at the bottom of the
screen, or by typing the COMMA key on the VT100 auxiliary keypad.

The file is spooled to logical name SYS$PRINT. If you want the file to
be printed on a particular line printer, direct SYS$PRINT to the
appropriate queue. For example, to print files on our lowercase line
printer, issue the following command before running LIST:

$ DEFINE SYS$PRINT LPB0

After the file is spooled to the line printer, it is automatically closed
and the next file (if any) is listed.

Also, any key on the VT100 auxiliary keypad can now be used to terminate a
LIST command at the bottom of the screen (i.e., EXIT). Previously, any
command terminated by a key on the auxiliary keypad was ignored.

******************************************************************************

Problems:

1. The search command only searchs forward through the file.
2. Scrolling backward through a file, such as embedded carriage control,
does not update the screen properly on a VT100. A temporary solution
is too type the REFRESH command to get an accurate display.
3. Moving the margin by less than a tab stop sometimes causes problems.

Notes:

1. The largest record size that can be listed is 512 bytes.
2. When listing binary data such as task images and librarys, use the
/-VFU (disable vertical format conversion) and /SEEALL mode to
display non-printable characters.