Previous Topic: VARTABLE DELETE Command—Delete a Vartable Entry

Next Topic: VARTABLE GET Command—Get a Vartable Entry


VARTABLE FREE Command—Delete Vartable

The VARTABLE FREE command deletes (frees) an existing memory-resident vartable. Use it to delete all entries in the table and the table definition itself. The command also frees all storage associated with the table.

This command has the following format:

VARTABLE FREE ID=tablename [SCOPE=scope]
ID=tablename

Specifies the name of the table.

Characters: A through Z, a through z, 0 through 9, #, $, and @

Limits: 1 through 12 characters

SCOPE={SYSTEM | PROCESS | REGION}

Specifies the scope of the vartable.

Default: PROCESS

Example: VARTABLE FREE

'vartable free  id=rxtest scope=region'

Return Codes

The codes returned are the same as the &ZFDBK values as documented for the NCL &VARTABLE verb.

The return codes are as follows:

0

Indicates that the request was satisfied.

16

Indicates that no table of this name exists in this scope.