NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE DELETE
Verbs
106126 Tandem Computers Incorporated 3–195
VARTABLE DELETE The VARTABLE DELETE verb deletes an entry from an existing memory-resident
table of variables (vartable).
The delete operation can occur concurrently with vartable updating in other processes.
If you want to delete or update a vartable entry, it is recommended that you use a
correlator to synchronize any accesses to the entry. See the VARTABLE GET verb in
this section for a definition of a correlator.
A return code is set in the &SYS.FDBK system variable if the operation is unsuccessful.
Return codes are presented later in the discussion of this verb.
Syntax errors in the VARTABLE DELETE statement causes the NCL procedure to
terminate.
VARTABLE DELETE ID= tablename
[ SCOPE={ CACHED | G90PRC | ENV | GLOBAL |
PROCESS | REGION } ]
KEY= keyname
[ FIELDS= fieldlist VARS= output-vars-list ]
ID= tablename
specifies the name of the table from which you need to delete 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 DELETE 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.