GETLIST, GETLISTV

The GETLIST statement restores a select list from the $SAVEDLISTS file. The GETLISTV statement is similar but creates a select list variable.

Format

GETLIST name {TO list.no} {SETTING count.var}

{THEN statement(s)}

{ELSE statement(s)}

GETLISTV name TO list.var {SETTING count.var}

{THEN statement(s)}

{ELSE statement(s)}

where

name	is the name of the $SAVEDLISTS entry to be restored.

list.no

is the select list number to which it is to be restored. If omitted, this defaults to zero.

list.var

is the select list variable to be created.

count.var

is the variable to receive the item count.

statement(s)

are statements to be executed depending on the outcome of the operation.

The GETLIST and GETLISTV statements restore the previously saved select list identified by name from the $SAVEDLISTS file. The disk copy is not removed by this operation.

The @SELECTED variable can be examined to determine the number of items in the list. Alternatively, the SETTING clause can be used to set count.var to this value.

At least one of the THEN and ELSE clauses must be present. If the list is successfully restored, the THEN clause is executed. If the list does not exists or cannot be restored for any other reason, the ELSE clause is executed.