NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE GET
Verbs
106126 Tandem Computers Incorporated 3–205
GEN
specifies the lowest key value generically equal to (matching) the supplied
search key for its nonblank length. It may have other characters after it.
IGEN
specifies the longest nonblank key value that matches the search argument. If
the key specified in KEY=& keyname is “ABCDE,” the search looks for a
record beginning with all five characters. If no record is found, the search is
restarted using a new search key equal to the old one, with the last nonblank
character deleted. This process is repeated until a record is found with a
matching key. A record with an all-blank key is only matched by specifying
an all blank search key.
OLDEST
specifies the oldest table entry. You may not specify KEY=& keyname if this
operand is specified.
NEWEST
specifies the newest table entry. You may not specify KEY=& keyname if this
operand is specified.
Considerations
The &SYS.FDBK system variable is set after a VARTABLE GET statement,
indicating one of the following results:
Return
Code
Description
0 The entry was retrieved successfully. Any supplied variables are updated.
4 No entry with the requested key value exists.
12 The supplied key value was longer than the table key length.
16 No table of this name exists in this scope.
To use SCOPE=CACHED, the vartable must have been initially allocated as a global
or a cached vartable.
When an NCL process issues VARTABLE GET SCOPE=CACHED for the first
time, NCL copies the global table into the operating system process, creating a
local copy of the vartable; this is then used to satisfy all subsequent VARTABLE
GET SCOPE=CACHED requests.
All updates to a global vartable are propagated through all local copies in all
operating system processes.
When SCOPE=CACHED is used, it should continue to be specified in all subsequent
VARTABLE GET requests until the vartable is no longer needed, or until a large
number of updates are required.