LIST
Generates a formatted listing of the contents of a file based on the selection criteria entered.
Syntax
LIST
Refer to Sentence Structure for descriptions of these parameters and the standard options.
Comments
If you do not specify an output specification clause, the processor uses the default output attributes defined in the dictionary. If there are no default attributes, the processor lists the item-ids only.
Examples
The first example illustrates the simplest form of the sentence. Data is output with the default output specification (attribute headings) as given by the file's dictionary.
:LIST GUESTS
PAGE 1 10:02:47 29 APR 1994
GUESTS... Guest Name........ Address......... City........ Arrival.
Date
401 Sharon R. Palmer 39 Chambers St. Atlanta 04/19/94
147 Loretta T. Janson 23 Glenborn Av. Los Angeles 04/27/94
318 Janis M. Petrillo 167 Market Sq. Haddonfield 04/27/94
234 Michael McSweeney 1015 Harrison Blvd Cambridge 03/31/94
. . . . .
26 ITEMS LISTED
In this example using NI-SUPP suppressed the counter message at the end of the report.
:LIST GUESTS NI-SUPP PAGE 1 10:02:47 29 APR 1994 GUESTS... Guest Name........ Address......... City........ Arrival. Date 401 Sharon R. Palmer 39 Chambers St. Atlanta 04/19/94 147 Loretta T. Janson 23 Glenborn Av. Los Angeles 04/27/94 318 Janis M. Petrillo 167 Market Sq. Haddonfield 04/27/94 234 Michael McSweeney 1015 Harrison Blvd Cambridge 03/31/94 . . . . .
In the next example, information is output in a columnar format because the specified data does not exceed the defined page width. Page widths are generally 80 columns for the terminal and 132 columns for the system printer. Note that an output specification clause is used. The H option is used instead of the modifier HDR-SUPP to suppress the default heading line.
:LIST GUESTS LAST-NAME ROOM ROOM-CODE LEAVE-DATE (H
GUESTS Last Name Room Room Leave Date
Code
401 Palmer 401 DL 09/09/94
147 Janson 147 D 09/16/94
318 Petrillo 318 ST 09/07/94
234 McSweeney 234 ST 09/11/94
. . . . .
In the next example, the specified information exceeds the page width. Therefore, the headings are displayed on the left followed by the associated information. Note that in this example, the modifier HDR-SUPP is used instead of the H option.
:LIST GUESTS LAST-NAME NAME ADDRESS CITY STATE ZIP ARRIVE-DATE LEAVE-DATE STAY PAY-CODE ROOM ROOM-CODE ROOM-TYPE BILL-DATE BILL-TOTAL HDR-SUPP GUESTS : 401 Last Name Palmer Guest Name Sharon R. Palmer Address 39 Chambers St. City Atlanta State GA Zip 34478 Arrive Date 09/01/94 Leave Date 09/09/94 Length of stay 8 Pay Code C Room 401 Room Code DL Room Type Deluxe Bill Total $149.25 GUESTS : 147 Last Name Janson Guest Name Loretta T. Janson Address 23 Glenborn Av. City Los Angeles . . .