NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE GET
Verbs
106126 Tandem Computers Incorporated 3–203
DELETE
specifies whether the retrieved entry is to be deleted. DELETE=NO specifies that
the entry is not deleted. DELETE=YES specifies that the retrieved entry is deleted
from the table.
NO
specifies that NCL does not delete the entry.
YES
specifies that NCL deletes the entry.
FIELDS= fieldlist
specifies the information you want to retrieve. fieldlist is a list of names in the
format:
name
( name )
( name , name … )
name must be one of the values shown in the following table; the names are
mutually exclusive:
Value Description
.KEY or KEY Specifies that you wish to receive the actual key value of this entry. This may
be different from the supplied search key if using OPT= other than KEQ. If
the same variable as the search key (KEY=&) is used in the field list, its value
is updated after the search key value is extracted.
DATAn or Dn Specifies that you wish to retrieve a data field from the entry. The value of n
must be between 1 and the value specified in the DATA= parameter of the
VARTABLE ALLOC statement for this table. You may have several DATAn
entries. Each entry must have a unique number n. If n is greater than 128,
you must retrieve data fields using the D* method of retrieval, described next.
DATA* or D* Specifies that you wish to retrieve all data fields in this entry. The
accompanying variable in the VARS=& list must be in the format prefix*. The
suffixes generated to access the variables are from 1 through n. This form
must be used if you want to access data fields where n is greater than 128.
.COUNTER or
COUNTER
Specifies that you wish to retrieve the current value of the system-maintained
counter field for this entry.
.USERCORR or
USERCORR
Specifies that you wish to retrieve the system-maintained user correlator
value for this entry. This value may be used in a later VARTABLE UPDATE,
PUT, or DELETE statement to ensure no other updates have taken place.