NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE UPDATE
Verbs
3–222 106126 Tandem Computers Incorporated
Considerations
The &SYS.FDBK system variable is set after a VARTABLE UPDATE statement,
indicating one of the following results:
Return
Code Description
0 The entry was updated successfully.
4 No entry with the supplied key value exists.
8 An entry with the supplied key value exists but the supplied user correlator value did
not match the user correlator value in that entry.
12 The supplied key value was longer than the table key length.
16 No table of this name exists in this scope.
20 The table was allocated with USERCORR=YES specified, and no user correlator was
supplied on the VARTABLE UPDATE statement.
The FIELDS and VARS operands enable you to specify the information you wish
to store in the new table entry and the NCL variables that the information is to be
extracted from. You must specify both of these 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.
See also VARTABLE ALLOC, which sets the correlation protection option.
For more information on cached vartables, see VARTABLE GET in this section.
For more information on VARTABLE verbs, refer to the NonStop NET/MASTER
NCL Programmer's Guide.