NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE FREE
Verbs
3–200 106126 Tandem Computers Incorporated
GLOBAL
specifies that the named table is visible to all NCL processes executing in the
current NonStop NET/MASTER MS system.
PROCESS
specifies that the named table is visible to the current NCL process only. This
includes all NCL procedures in the current NCL process.
REGION
specifies that the named table is visible to all NCL processes executing in the
current region. This includes any EXEC, START, or INTCMD NCL processes
in this region and any NCL processes executing in the other opened OCS
window.
Considerations
The &SYS.FDBK system variable is set after a VARTABLE FREE statement,
indicating one of the following results:
Return
Code
Description
0 The table was freed successfully.
16 No table with this name exists in this scope.
Using VARTABLE FREE with SCOPE=CACHED ensures that the cached copy is
deleted before returning to the NCL process. If you specify SCOPE=GLOBAL,
return to the NCL process is immediate; however, the deletion of the local copy of
the vartable might not have completed.
As a result of the updating method for cached copies of global vartables, processes
that update a cached global vartable can be guaranteed a consistent view of that
vartable only if they use SCOPE=CACHED.
See also VARTABLE DELETE and VARTABLE RESET. VARTABLE DELETE
deletes a single entry from an existing vartable. VARTABLE RESET deletes
multiple entries from an existing vartable without changing its definition.
For more information on cached vartables, see VARTABLE GET, next in this
section.
For more information on VARTABLE verbs, refer to the NonStop NET/MASTER
NCL Programmer's Guide.
Example
The following example frees the private table called MYTABLE:
VARTABLE FREE ID=MYTABLE