INQUIRE TRANCLASS

Retrieve information about a transaction class.

Read syntax diagramSkip visual syntax diagramINQUIRE TRANCLASS
 
>>-INQUIRE TRANCLASS(data-value)-------------------------------->
 
   .----------------------------.
   V                            |
>----+------------------------+-+------------------------------><
     +-ACTIVE(data-area)------+
     +-MAXACTIVE(data-area)---+
     +-PURGETHRESH(data-area)-+
     '-QUEUED(data-area)------'
 

Conditions: INVREQ, NOTAUTH, TCIDERR

Description

The INQUIRE TRANCLASS command allows you to determine the limits defined for a transaction class and the current activity within the class.

Browsing

You can also browse through the definitions of all the transaction classes in your system by using the browse options (START, AT, NEXT, and END) on INQUIRE TRANCLASS commands. In browse mode, definitions are returned in alphabetical order, and you can specify a starting point with the AT option if you wish. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

ACTIVE(data-area)
returns a fullword binary field giving the current number of tasks in this class. This count does not include tasks that are queued waiting for initial dispatch.
MAXACTIVE(data-area)
returns a fullword binary field giving the largest number of tasks in the transaction class which are allowed to run concurrently.
PURGETHRESH(data-area)
returns a fullword binary field giving the maximum number of tasks in this class that can be queued awaiting initial dispatch (see the QUEUED option). Tasks in this class that arrive while the queue is at its PURGETHRESH limit are purged.
QUEUED(data-area)
returns a fullword binary field giving the number of tasks that are queued awaiting initial dispatch. Queuing occurs either because the number of active tasks is already at the maximum, or because the maximum for the system has been reached (see the MAXTASKS option in the INQUIRE SYSTEM command).
TRANCLASS(data-value)
specifies the 8-character name of the transaction class about which you are inquiring. If the class is one of the numbered classes used in earlier releases of CICS, its name is DFHTCLnn, where nn is the two-digit class number.

Conditions

INVREQ
RESP2 values:
12
The TRANCLASS definition is in use.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
101
The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.
TCIDERR
RESP2 values:
1
The transaction class cannot be found.
[[ Contents Previous Page | Next Page Index ]]