GET.LIST

GET.LIST

Top  Previous  Next

 

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.nameis the name of the file from which the list is to be retrieved. This defaults to $SAVEDLISTS if omitted.

 

list.nameis 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.nois 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.SUPsuppresses display of the number items in the restored list.

 

DELETINGdeletes 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.

 

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.

 

 

See also:

COPY.LIST, DELETE.LIST, EDIT.LIST, FORM.LIST SAVE.LIST, SORT.LIST