NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE DELETE
Verbs
106126 Tandem Computers Incorporated 3–197
name must be one of the values shown in the following table; the names are
mutually exclusive:
Value Description
.USERCORR or
USERCORR
A user correlator value, obtained from a previous VARTABLE GET, is
supplied to check for synchronization. The corresponding variable in the
VARS list has the value.
VARS= output-vars-list
specifies the NCL variables that contain the information for each entry in
fieldlist . There is a one-to-one correspondence from each entry in
output-vars-list to the same entry in fieldlist . The first entry in
output-vars-list specifies the variable containing the data for the first entry
in fieldlist .
Considerations
The &SYS.FDBK system variable is set after a VARTABLE DELETE statement,
indicating one of the following results:
Return
Code
Description
0 The entry was deleted successfully.
4 No entry with the supplied key value exists.
8 The value of the supplied user correlator does not match the value in the table entry.
12 The supplied key value was longer than the table key length.
16 No table of this name exists in this scope.
The FIELDS and VARS operands enable you to specify a user correlator value for
validation against the current table contents. You must specify both parameters or
omit both. If specified, the two parameters must have the same number of entries
in their lists.
Changes to a vartable using SCOPE=CACHED are carried out simultaneously in
all processes that contain the vartable as a cached copy. Such changes are applied
to the local cache copy, and also to the global copy. Return to the process is
delayed until the changes have been carried out. If you specify SCOPE=GLOBAL,
any changes are applied only to the global copy of the vartable prior to returning
to the process; consequently, there may be some delay before the local copy of the
table is updated.
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.
For more information on cached vartables, see VARTABLE GET in this section.
See also VARTABLE FREE and VARTABLE RESET. VARTABLE FREE deletes an
entire vartable and all associated storage. VARTABLE RESET deletes multiple
entries from an existing vartable without changing its definition.