# 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
```

## See also

- [File reference (Access Query Language)](https://d3codex.com/access/file-reference-access-query-language/)
- [Item list](https://d3codex.com/access/item-list/)
- [Options (Access Query Language)](https://d3codex.com/access/options-access-query-language/)
- [Selection criteria](https://d3codex.com/access/selection-criteria/)
- [sort-label command](https://d3codex.com/access/sort-label-command/)

---
Source: https://d3codex.com/access/list-label-command/ - part of the D3Codex reference.