NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE PUT
Verbs
3–208 106126 Tandem Computers Incorporated
VARTABLE PUT The VARTABLE PUT verb adds to or updates an entry in an existing memory-resident
table of variables (vartable). If there is no entry with a matching key, the entry is
added. If an entry with a matching key already exists, the entry is updated.
The PUT 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 PUT statement cause the NCL procedure to
terminate.
VARTABLE PUT 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 PUT verb
returns. However, if a previous VARTABLE GET SCOPE=CACHED has not
been issued, this operand is interpreted as SCOPE=GLOBAL. See VARTABLE
GET, in this section for further information.