# Listings

A listing is the printed output resulting from a command that uses the list keyword (of which there are many).

When the length of the output is below the threshold for number of lines of output, as set in the “Listings” page in the i Options dialog, the output is shown in the console. When the output exceeds the threshold, it is put into its own the i Listing pane. The output in the pane is static — it is not updated or altered from any subsequent program operation. The Listing pane provides tools for working with the output, including copying text and exporting to file output. There is no limit to the number of listing panes that may be opened.

Commands that Use list

program list security
program list cycle-sequence


The list keyword appears in many commands (e.g., program list cycle-sequence, zone list stress, ball list property). It is used to obtain text-based information about the object that uses it, with keywords following to identify what aspect of the object is needed. As with all commands, its output is expected to be processed in the i Console pane. However, a listing is created instead in an automatically-generated i Listing pane when the output of a list-type command exceeds a certain number of lines.

The number of lines used as the threshold for creating Listing panes may be specified in the i Listings page of the i Options dialog.

For comparison, type both commands shown above at the command prompt in the Console pane. Assuming the listing threshold in the i Options dialog is set at about 10 or less, output from the first command appears in the Console pane. Output from the second goes into a Listing pane.

Note

As is noted elsewhere, all c program commands may omit the leading word program. The commands shown above may be issued as list security and list cycle-sequence.