LIST-LABEL
Arranges data in label format. Each 'element' of each data item, where an 'element' is a part of the item down to subvalue level, is put on a new line. After you type a sentence, the command prompts you for format information such as number of columns and rows, indentation, and spacing.
Unless any sort criteria specify otherwise, LIST-LABEL outputs the specified information in the order that items are found in the file.
Syntax
LIST-LABEL file-specifier
{item-list} {selection-criteria}
Refer to Sentence Structure for descriptions of these parameters.
Prompts
After the sentence is entered, the processor prompts for the desired format as follows:
COL,ROW,SKIP,INDENT,SIZE,SPACE(,C):
COL Number of columns required to list the data across the page.
ROW Number of lines for each item.
SKIP Number of blank lines between each item.
INDENT Number of spaces for left margin.
SIZE Number of spaces required for the data under each column.
SPACE Number of horizontal spaces to skip between columns.
C Optional. Suppress null or missing data. If absent, null or missing values are output as blanks.
SORT-LABEL
Use SORT-LABEL if you need the items sorted.
Rules
The total number of horizontal specifications must not exceed the current page width. That is:
COL * (SIZE + SPACE) + INDENT <= page width
The ROW count specification must be a minimum of one for each attribute, plus one for the item-id if the ID-SUPP modifier or the I output option is not used.
If INDENT is nonzero, the processor prompts for "HEADER:" corresponding to the number of attributes included in each label. (If item-ids are not suppressed, the first row of each label will have the item-id, that is, attribute 0.) The information entered at this prompt produces a heading in the left margin. If a heading is not required for a particular line, press RETURN.
Multivalues within attributes are listed on separate lines.
If LIST-LABEL is executed from a Proc and the parameters are stacked within that Proc, the prompt asking for column, row, and so forth is not displayed.
If the COL-HDR-SUPP or HDR-SUPP modifier or the C or H option is specified, the page number, date, and time are not printed and the report is generated without page breaks in a continuous format.
If the ID-SUPP modifier or the 'I' output option is not specified, the item-ids are output as the first line of the label.
Conversions codes in the dictionary are applied.
Example
:LIST-LABEL GUESTS NAME ADDRESS CITY STATE ID-SUPP COL-HDR-SUPP COL,ROW,SKIP,INDENT,SIZE,SPACE,(,C): 2,4,2,0,25,8,C Sharon R. Palmer Loretta T. Janson 39 Chambers St. 23 Glanborn Av. Atlanta Los Angeles GA CA Janis M. Petrillo Michael McSweeney 167 Market Sq. 1015 Harrison Blvd. Haddonfield Cambridge CT MA D. Taylor Loretta Rizzo . . . . . .