NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE ADD
Verbs
3–186 106126 Tandem Computers Incorporated
VARTABLE ADD The VARTABLE ADD verb adds an entry to an existing memory-resident table of
variables (vartable). A return code is set in the &SYS.FDBK system variable if the
operation is unsuccessful.
Syntax errors in the VARTABLE ADD statement cause the NCL procedure to
terminate.
VARTABLE ADD 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 ADD 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, 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.
Note For further information about NCL processes executing in Guardian processes, see the NonStop
NET/MASTER MS System Management Guide.