NET/MASTER Network Control Language (NCL) Reference Manual

VARTABLE ALLOC

Verbs

106126 Tandem Computers Incorporated 3–193

LIMIT

specifies whether the table is to have a limit on the number of entries.

specifies that the table can have any number of entries.

specifies that no more than

entries (for

equal to 1 through 1,000,000) can be

added to the table. If a VARTABLE ADD or VARTABLE PUT causes this limit

to be exceeded, and DELOLD=NO is specified, the addition is not performed,

and the &SYS.FDBK system variable is set to 24 for the VARTABLE PUT and

VARTABLE ADD verbs. If DELOLD=YES is specified, the addition is

performed and the oldest entry is deleted to make room.

USERCORR

specifies that the user wants to have synchronized correlation protection on entries

in the vartable. This operand allows control over the use of the USERCORR field

in table entries when performing VARTABLE UPDATE, VARTABLE DELETE, or

VARTABLE PUT operations.

specifies that user correlation is optional.

YES

specifies that user correlation is required when updating table entries.

Considerations

The &SYS.FDBK system variable is set after a VARTABLE ALLOC statement,

indicating one of the following results:

Return

Code

Description

0 The table was allocated successfully.

16 A table with this name already exists in this scope.

Efficiency is greatly enhanced by using SCOPE=CACHED with the VARTABLE GET

verb when it is necessary to create global vartables that are read frequently but

updated rarely.

For global vartables (defined by SCOPE=GLOBAL) the total length of data and

control information must not exceed 10000 characters.

SCOPE=GLOBAL is synonymous with SCOPE=CACHED in allocating vartables using

this verb.