SET TCLASS

Set the maximum number of tasks in a transaction class.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

SET TCLASS

Conditions: INVREQ, NOTAUTH, TCIDERR

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

This command is threadsafe.

Description

The SET TCLASS command allows you to set the maximum number of tasks in a particular transaction class that are allowed to run concurrently.

This command is limited to the numbered classes of earlier releases of CICS® and is retained for compatibility with those releases. The SET TRANCLASS command, described on page SET TRANCLASS, provides the same function and can be used for either the old numbered or new named classes.

Options

MAXIMUM(data-value): specifies, as a fullword binary value, the largest number of tasks in the transaction class that are allowed to run concurrently. The value can be in the range 0 through 999. (This value corresponds to the MAXACTIVE value in a SET TRANCLASS command. See the description of this option on page SET TRANCLASS for a description of what happens when you change the MAXACTIVE limit.)
TCLASS(data-value): specifies, as a fullword binary value, the number of the task class that you are changing. It must be in the range 0 –10.

Conditions

INVREQ

RESP2 values:

2: The MAXIMUM value is not in the range 0-999.

NOTAUTH

RESP2 values:

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

TCIDERR

RESP2 values:

1: The transaction class cannot be found.