list-label command

The list-label command produces one or more columns of output.

Syntax

list-label file.reference {item.list} {selection.criteria} {output.specification}
{modifiers} {(options)}

Description

After pressing ENTER to submit the AQL sentence for processing, a ? prompt displays. This prompt supplies the label output parameters separated by commas:

columns,rows,skip,indent,size,space,c

where

columns Number of labels across the page.
rows Number of print lines on each label.
skip Number of lines (vertically) between labels.
indent Number of spaces to indent from left margin.
size Number of print positions per label.
space Number of spaces (horizontally) between labels.
c Compresses null values.

If the indent parameter is not zero, this command prompts for entry of the header text for each print line requested. If any text is entered at any of these prompts, that text displays before the corresponding print line on the leftmost (1st) column only. Pressing ENTER at any of these prompts indicates a null header.

The labels are printed in the same order as the items display in the file. To change the ordering use the sort-label command.

Note: This command can stop with a message indicating that the range of the parameter is unacceptable. This occurs when the total width of the labels, including spaces between each column, is greater than the width of the output device, as determined by the term command.

If problems exist with the formatting of the list-label output, try using the tcl-hdr-off command first and a k option with the list-label command.

Example(s)

The label parameters shown define the output as having 2 labels across, 4 lines each (contact, company, address, and csz), skip 1 line, indent 0 (zero - assumes labels are aligned at the first print position), 30 print positions each (longer strings are truncated to 30, in this case), space over 2 to the right between each label, and c for compress nulls (do not allow blank lines within the label).

list-label entity contact company address csz (cip
? 2,4,1,0,30,2,c