NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE FREE
Verbs
106126 Tandem Computers Incorporated 3–199
VARTABLE FREE The VARTABLE FREE verb deletes (frees) an existing memory-resident table of
variables (vartable). Use this verb to delete all entries in the table and the table
definition itself. This verb also frees all storage associated with the table.
Syntax errors in the VARTABLE FREE statement cause the NCL procedure to
terminate.
VARTABLE FREE ID= tablename
[ SCOPE={ CACHED | G90PRC | ENV | GLOBAL |
PROCESS | REGION } ]
ID= tablename
specifies the table to be freed. tablename can be any valid expression; it must be
the name of an existing vartable in the specified SCOPE. tablename must have a
length of 12 characters or fewer, and must consist of the following characters:
Alphabetic characters: A through Z and a through z
Numeric characters: 0 through 9
Other characters: ^ ~ # $ ( ) - . : @ [ \ ] _ ` |
SCOPE
specifies in which scope the table is to be found.
CACHED
specifies that the named table is a local copy of a global table. If a previous
VARTABLE GET SCOPE=CACHED verb has been issued, the local copy of
the table is guaranteed to be updated before the VARTABLE FREE verb
returns. However, if a previous VARTABLE GET SCOPE=CACHED verb has
not been issued, this operand is interpreted as SCOPE=GLOBAL. See
VARTABLE GET, in this section, for further information.
G90PRC
specifies that the visibility of the named table is restricted to NCL processes
executing in the same Guardian process. This option is useful to improve
performance when some sharing is necessary but full global scope is not
required.
Note For further information about NCL processes executing in Guardian processes, see the NonStop
NET/MASTER MS System Management Guide.
ENV
specifies that the named table is visible to all NCL processes executing in the
current environment.