SAVE.LIST

SAVE.LIST

Top  Previous  Next

 

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

 

list.nameis 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.noidentifies the select list (0 to 10) to be saved. If omitted, select list zero is used.

 

COUNT.SUPsuppresses display of the number items in the saved list.

 

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

 

 

See also:

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