HP 3000 Manuals HP 3000 Manuals
LIST
3-68. LIST COMMAND
3-69. Purpose.
The LIST command displays all or a portion of the WORK file.
3-70. Form.
The form of the LIST command is
L[IST][Q] [range] [,UNN[UMBERED] ][,OFFLINE][,TRANSLATE][,NOTEXT]
3-71. Description.
The LIST command lists the lines of the WORK file contained in range. If
range is not specified or if range is an asterisk (*), the line
containing the pointer is displayed. If range is ALL, the entire
contents of the WORK file are displayed.
If the Q or UNNUMBERED parameters are specified, only the text of each
line in range is listed, without the line numbers.
Unless the OFFLINE parameter is specified, the listing is displayed on
the standard output device (OUTPUT file). If OFFLINE is specified, the
WORK file is listed on the device class LP, unless an altemative output
device is specified with the MPE :FILE command. (See paragraph 3-73,
EXAMPLES.) The number of lines printed on each page of an offline listing
will be 60, unless otherwise specified by the SET LINES parameter. (See
paragraph 3-95.)
If the system does not have a device class of LP, the message "*OFFLINE
LIST DEVICE NOT AVAIL- ABLE" appears. You must, in this case, use a file
equation with the proper device class.
NOTE This feature must be included at configuration and may vary from
installation to installation.
The TRANSLATE parameter causes all lowercase characters to be shifted to
uppercase for the listing only. The contents of the WORK file are not
altered, only the listing is affected.
The NOTEXT parameter causes a listing of line numbers only, without the
text of the lines. (This is useful for determining what line numbers
exist within a range.)
Parameters for the LIST command may be specified in any order as long as
they are separated by commas. Some combinations, however, such as
UNNUMBERED (or Q) and NOTEXT, obviously are incompatible.
3-72. Limitations.
The LIST command displays only those characters within the SET LEFT, SET
RIGHT margins in effect. See paragraph 3-92 for a discussion of the SET
command.
3-73. Examples.
Several variations of the LIST command are shown in the following
examples. The location of the pointer is illustrated after the
conclusion of each LIST command.
* LIST range
This example specifies a range of 3/6 and only lines 3 through 6 are
listed. After the command is executed, the pointer is located at
position 1 of line 7 (the line following the last line listed).
1 1-2. WHAT IS EDIT/3000?
2
3 EDIT/3000 IS A SUBSYSTEM OF THE HP 3000
4 MULTIPROGRAMMING EXECUTIVE OPERATING SYSTEM
5 (MPE/3000) THAT IS USED TO CREATE AND
6 MANIPULATE ASCII FILES.
7
8 CHARACTERS, STRINGS OF CHARACTERS, OR ENTIRE
9 LINES OF CHARACTERS CAN BE INSERTED, DELETED,
10 REPLACED, MODIFIED, SEARCHED FOR, AND OTHERWISE
11 MANIPULATED BY USING EDIT/3000 COMMANDS.
/LIST 3/6
3 EDIT/3000 IS A SUBSYSTEM OF THE HP 3000
4 MULTIPROGRAMMING EXECUTIVE OPERATING SYSTEM
5 (MPE/3000) THAT IS USED TO CREATE AND
6 MANIPULATE ASCII FILES
/FIND *
7
^ (1 )
* LISTQ range and LIST range UNN[UMBERED]
When the LISTQ and LIST UNNUMBERED forms of the command are used as in
the sollowing example, the text, but not the line numbers, of each line
in range is listed.
/LISTQ 3/6
EDIT/3000 IS A SUBSYSTEM OF THE HP 3000
MULTIPROGRAMMING EXECUTIVE OPERATING SYSTEM
(MPE/3000) THAT IS USED TO CREATE AND
MANIPULATE ASCII FILES
/FIND *
7
^ (1 )
/LIST 3/6,UNNUMBERED
EDIT/3000 IS A SUBSYSTEM OF THE HP 3000
MULTIPROGRAMMING EXECUTIVE OPERATING SYSTEM
(MPE/3000) THAT IS USED TO CREATE AND
MANIPULATE ASCII FILES.
/FIND*
7
(1 )^
* LIST range, NOTEXT
This form of the LIST command causes EDIT/3000 to display line numbers
only; the text of the lines in range is not listed.
/LIST 3/6,NOTEXT
3
4
5
6
/FIND *
7
^ (1 )
* LIST range,OFFLINE
The LIST range, OFFLINE command sends the WORK file records to listfile
instead of displaying the records on the standard list device.
The listfile can be declared in the MPE/3000 :EDITOR and :FILE commands
and equated to an altemative output device. In the first example
following, the file OUT is declared and equated to a line printer (which
is not the standard list device in a session). When EDIT/3000 is
accessed, the :EDITOR *OUT command is used, back-referencing the file
OUT. The LIST ALL ,OFFLINE command causes the contents of the WORK file
to be listed on the line printer.
:FILE OUT; DEV=FASTLP
:EDITOR *OUT
HP32201A.4.01 EDIT/3000 TUE, MAY 13, 1975, 10:12 AM
/TEXT EDIT2
/LIST ALL,OFFLINE
*** OFF LINE LISTING BEGUN. ***
NOTE The listing below was printed on the line printer.
1 1-2. WHAT IS EDIT/3000
2
3 EDIT/3000 IS A SUBSYSTEM OF THE HP 3000
4 MULTIPROGRAMMING EXECUTIVE OPERATING SYSTEM
5 (MPE/-3000) THAT IS USED 10 CREATE AND
6 MANIPULATE ASCII FILES.
7
8 CHARACTERS, STRINGS OF CHARACTERS, OR ENTIRE
9 LINES OF CHARACTERS CAN BE INSERTED, DELETED,
10 REPLACED, MODIFIED, SEARCHED FOR, AND OTHERWISE
11 MANIPULATED BY USING EDIT/3000 COMMANDS.
If EDIT/3000 has been accessed without specifying an offline list file,
an offline listing can be obtained on devices other than LP as follows:
a. Enter the following: FILE command from within EDIT/3000:
:FILE EDTLIST;DEV= FASTLP
where FASTLP is the desired device class name (FASTLP is a line
printer on the system used in the example) and EDTLIST is the formal
file designator for EDIT/3000 offline listings.
b. Enter the EDIT/3000 command.
* LIST ALL,OFFLINE
EDTLIST is EDITOR's formal designator for the offline output list file.
EDTLIST is used for the LIST, OFFLINE and XPLAIN, OFFLINE commands.
EDITOUT is EDITOR's formal designator for the output list file
($STDLIST).
EDITIN is EDITOR's formal designator for the input file ($STDINX).