NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE GET
Verbs
106126 Tandem Computers Incorporated 3–201
VARTABLE GET The VARTABLE GET verb retrieves (gets) an entry from an existing memory-resident
table of variables (vartable). It is not necessary to know the exact key of the record.
The VARTABLE GET verb must be used if a user wants to know the current value of
the correlator for an entry in the table. This information is important if an entry is
going to be changed or deleted. If you attempt to change a vartable entry that is
protected by a correlator value, and you do not specify the correct correlator value, an
error code is set in the &SYS.FDBK system variable. The USERCORR operand in the
VARTABLE ALLOC verb sets the correlator protection feature.
Syntax errors in the VARTABLE GET statement cause the NCL procedure to
terminate.
VARTABLE GET ID= tablename
[ SCOPE={ CACHED | G90PRC | ENV | GLOBAL |
PROCESS | REGION } ]
[ AGE={ NO | YES } ]
[ DELETE={ NO | YES } ]
[ FIELDS= fieldlist VARS= output-vars-list ]
[ KEY= keyname ]
[ OPT=[ KEQ | KGE | KLE | KGT | KLT | FIRST |
LAST | GEN | IGEN | OLDEST | NEWEST ] ]
ID= tablename
specifies the table to be accessed. tablename can be any valid expression; it must
be the name of an existing vartable in the specified SCOPE. 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. Efficiency is
greatly enhanced by using this option when it is necessary to use global
vartables that are read frequently but updated rarely. The first use of the
VARTABLE GET SCOPE=CACHED verb in a process establishes a local
cached copy of a vartable having the same name and contents as the global
vartable.