GET.LIST

The GET.LIST command is used to restore a previously saved select list.

Format

GET.LIST {{file.name} list.name...} {TO list.no } { COUNT.SUP } {DELETING}

where

file.name

is the name of the file from which the list is to be retrieved. This defaults to $SAVEDLISTS if omitted.

list.name

is the name of the record in file.name that holds the saved select list. This defaults to "$temp.n" if omitted, where n is the QM user number.

list.no

is the select list number in the range 0 to 10 to which list.name is to be restored. If omitted, select list zero is used.

COUNT.SUP

suppresses display of the number items in the restored list.

DELETING

deletes the list from disk.

The GET.LIST command retrieves a previously saved select list from $SAVEDLISTS or an alternative file. If the target list list.no was already active, the retrieved list replaces the previous list.

Multiple list names may be specified in which case they will be concatenated to form a single list. Duplicate items are not removed.

Both @SYSTEM.RETURN.CODE and @SELECTED are set the number of items in the list.

See the SELECT command for a discussion of chained selection where a command can be executed automatically if the GET.LIST is successful.

Examples

GET.LIST OVERDUE.INVOICES

57 records selected.

This example restores the default select list from a list named OVERDUE.INVOICES in the $SAVEDLISTS file.

GET.LIST INVENTORY TO 3

91 records selected.

This example restores a select list saved as INVENTORY to select list 3.