SAVE.LIST

Top  Previous  Next

 

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

 

 

Format

 

SAVE.LIST list.name {FROM list.no}

 

where

 

list.nameis the name of the record to be created in $SAVEDLISTS to hold the saved select list.

 

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

 

 

The SAVE.LIST command copies an active select list to the $SAVEDLISTS file. This 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.

 

@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, GET.LIST