Previous: Listing and showing information
Up: Listing and showing information
Next: Display list files: TYPE, PRINT and SPOOL (T, P, SP)
Previous Page: Listing and showing information
Next Page: Display list files: TYPE, PRINT and SPOOL (T, P, SP)

Produce a formatted list of selections: LIST (L)

This command allows the user to list the catalogue items of a query table in a specified combination, order and format.

LIST[/qualifiers] [list string]

with the syntax of the list string:

[constant,]keyword[/key-qualifiers][,[constant,]keyword [/key-qualifiers][,..]]

A keyword indicates a catalogue item to be listed; all items on which the SELECT command (section ) can act can be listed (except LINE). Generic position keywords, such as POS, GAPOS, etc. , are allowed in the list string. Constants may be used to make a list more readable, for example:

LIST "RA=",RA,"DEC=",DEC, etc. .

If the specified list contains more than 1000 records, ARCQUERY will prompt for confirmation. A (long) list can be interrupted with CTRL/C; the display on the VDU can be suppressed with CTRL/L, but if, for instance, the /FILE qualifier is used, the list file will be completed.

Some specific qualifiers for the LIST command are:

• /FILE, indicating whether a list file should be created; default: /NOFILE.
• /SPLIT, indicating whether lines, longer than the page width in a print file will be split over as many pages as needed; default: /SPLIT, unless /TRUNCATE is specified.
• /TRUNCATE, indicating that lines longer than the page width will be truncated; default /NOTRUNCATE.
• If both /NOSPLIT and /NOTRUNCATE are specified, lines are continued on the same page (next line) and a blank line is inserted before each item.

Table specifies the default representation of the various items in the Observations Catalogue. However, the user may control the list format of every individual item by using key-qualifiers with the keywords in the list string:

• /[NO]DECODE to determine whether the item is listed in the coded form, in which it occurs in the Observations Catalogue, or in a decoded form.
• /NRVALUES= to specify the number of values to be listed, when applicable.
• /UNIT= to determine the units to be used.
• /WIDTH= to specify the total width of the list item field.
• /NRDECIMALS= to specify the number of decimals to be displayed.
• /DATE_FIELD= to specify the list format of the date, if it has to differ from the default DD-MMM-YY format; options are: DAY (of the month only), MONTH, YEAR, WEEKDAY, YYDDD, YMD (YY/MM/DD) and MDY (MM/DD/YY).

The key qualifiers /COORD=, /EQUIN=, and /FORMAT have the same effect as if used as command qualifiers (see table ).