NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE PUT
Verbs
106126 Tandem Computers Incorporated 3–211
Considerations
The &SYS.FDBK system variable is set after a VARTABLE PUT statement,
indicating one of the following results:
Return
Code
Description
0 The entry was updated successfully.
1 The entry was added successfully. The table was at the limit specified by the
VARTABLE ALLOC, and DELOLD=YES was specified with VARTABLE ALLOC. The
oldest entry was deleted to make room for this entry.
8 An entry with the supplied key value already exists, and the supplied user correlator
value did not match the user correlator value in that entry. The entry was not
updated.
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 PUT statement.
24 The table is already at the limit specified by VARTABLE ALLOC. The entry could not
be added.
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, earlier in this
section.
For more information on VARTABLE verbs, refer to the NonStop NET/MASTER
NCL Programmer's Guide.