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