INQUIRE TCLASS

Description

Use the INQUIRE TCLASS command to determine the current and maximum numbers of tasks in an installation-defined transaction class. This command is limited to the numbered classes of earlier releases of CICS and is retained for compatibility with those releases. The INQUIRE TRANCLASS command has the same function and can be used for either the old numbered or the new named classes.

Options

CURRENT(data-area)

Returns a fullword binary field giving the current number of tasks in the class about which you are inquiring. This number includes both tasks that are running and tasks that have not yet been dispatched because the maximum for either the class or the system has been reached. See the MAXIMUM option of this command and the MAXTASKS option of the INQUIRE SYSTEM command for more about these limits. The CURRENT value corresponds to the sum of the ACTIVE and QUEUED values in an INQUIRE TRANCLASS command, and therefore can exceed the MAXIMUM value.

MAXIMUM(data-area)

Returns a fullword binary field giving the largest number of tasks that are allowed to run concurrently in the class about which you are inquiring. This value corresponds to the MAXACTIVE value in an INQUIRE TRANCLASS command.

TCLASS(data-value)

Specifies the number of the task class about which you are inquiring, in fullword binary form. The number must be in the range 0-10.

Conditions

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

TCIDERR

RESP2 values:

1

The named task class cannot be found.