get-list Command

The get-list command activates an item-list from the pointer-file file. The default file is the pointer-file file.

NOTE

The temporary ADIs can also be used.

Syntax

get-list {{file.reference} list.name {list.name...}} {(adi.ref} {(options}

Synonym(s)

gl

Parameter(s)

file.reference

Specified file used to retrieve the item.

list.name...

Name of the list that contains the attributes to place in the active list. Multiple list names can be specified to create longer lists.

If more than one list name is specified, the lists are concatenated into a single list.

If no list name is specified, the default name, %user-ID, is used.

adi.ref

Indicates an attribute number. This creates a list from the specified attribute.

options

s

Creates a secondary list.

u

(Unique) Inhibits selection of duplicated items within multiple lists.

n #

Specifies to get only the nth attribute of the list.

m #- n #

Specifies to get from the mth to the nth attribute of the list.

Example(s)

get-list xx yy

[404] 358 items selected out of 2 items.

>

 

get-list duplicates

[404] 67 items selected out of 1 items.

>

This combines the two lists, old.invoices and new.invoices into one list. The u option eliminates redundant references within the list.

get-list old.invoices new.invoices (u

[404] 405 items selected out of 2 items.

See Also

.readnext Command, Active List, compare-list Command, copy Command, copy-list Command, delete-list Command, edit-list Command, fl Command, nselect Command, pointer-file File, qselect Command, readnext Statement, save-list Command, Secondary List, select Command, sort-list Command, sselect Command, u1195 User Exit