SAVE.LIST

The SAVE.LIST command is used to save an active select list for future use.

Format

SAVE.LIST {{file.name} list.name} {FROM list.no} {COUNT.SUP} {KEEP}

where

file.name

is the name of the file in which the list is to be saved. This defaults to $SAVEDLISTS if omitted. The DICT prefix can be used to save the list in a dictionary.

list.name

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

list.no

identifies the select list (0 to 10) to be saved. If omitted, select list zero is used.

COUNT.SUP

suppresses display of the number items in the saved list.

KEEP	Retains that active list, saving a copy of it.

The SAVE.LIST command copies an active select list to the $SAVEDLISTS or alternative file. When using $SAVEDLISTS, the file will be created if it does not already exist.

If the active list has already been partially processed, only the remaining items are saved. The active select list is cleared after it has been saved unless the KEEP option is used.

@SYSTEM.RETURN.CODE is set to the number of items in the saved list. In the event of an error, the value is a negative error code.

Example

SAVE.LIST INVENTORY FROM 3

Saved list 'INVENTORY' in $SAVEDLISTS.

This example saves active select list 3 as INVENTORY.