NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE UPDATE
Verbs
106126 Tandem Computers Incorporated 3–219
VARTABLE UPDATE The VARTABLE UPDATE verb updates an entry in an existing memory-resident table
of variables (vartable). The update operation can occur concurrently with vartable
updating in other processes. If you want to delete or update a vartable entry, it is
recommended that you use a correlator to synchronize any accesses to the entry. See
the VARTABLE GET verb in this section for an explanation of a correlator.
Syntax errors in the VARTABLE UPDATE statement cause the NCL procedure to
terminate.
VARTABLE UPDATE ID= tablename
[ SCOPE={ CACHED | G90PRC | ENV | GLOBAL |
PROCESS | REGION } ]
KEY= keyname
[ ADJUST= n | COUNTER= n ]
[ FIELDS= fieldlist VARS= output-vars-list ]
ID= tablename
specifies the name of the table to which you wish to add the entry. tablename
can be any valid expression. The table must have been previously allocated (not
necessarily by this procedure, unless SCOPE=PROCESS is specified). 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 UPDATE 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, earlier 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.