 |
» |
|
|
|
|  | |
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 alternative 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. 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 following 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 )^
|
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 )
|
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 alternative 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: 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. Enter the EDIT/3000 command.
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). |
