NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE QUERY
Verbs
106126 Tandem Computers Incorporated 3–213
VARTABLE QUERY The VARTABLE QUERY verb obtains information about a memory-resident table of
variables (vartable). You use this verb in an NCL procedure to inquire about the
existence of a given vartable. If it exists, you can optionally retrieve attribute
information.
Syntax errors in the VARTABLE QUERY statement cause the NCL procedure to
terminate.
VARTABLE QUERY ID= tablename
[ SCOPE={ CACHED | G90PRC | ENV | GLOBAL |
PROCESS | REGION } ]
[ FIELDS= fieldlist VARS= output-vars-list ]
ID= tablename
specifies the name of the table that you wish to inquire about. tablename can be
any valid expression. If the table has not been previously allocated, the procedure
does not fail. Instead, a return code 16 is returned in &SYS.FDBK system variable
to indicate that the table did not exist. 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. 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.
Note For further information about NCL processes executing in Guardian processes, see the NonStop
NET/MASTER MS System Management Guide.
ENV
specifies that the named table is visible to all NCL processes executing in the
current environment.