CEMT INQUIRE TCLASS

Retrieve information about tasks in a task class.

In the CICS Explorer, the Transaction classes operations view provides a functional equivalent to this command.

Description

The INQUIRE TCLASS command returns information about the current and maximum number of tasks, the purge threshold, and the status of a user-defined task class.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:

Type CEMT INQUIRE TCLASS (or suitable abbreviations for the keywords). The resulting display lists the current status.
Type CEMT INQUIRE TCLASS (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i tc p(value), the resulting display shows the details of only those transaction classes that have a purge threshold of the value indicated.

To change various attributes, use the CEMT SET TCLASS command.

(value): The 8-character transaction class name.
ALL: The default.

Sample screen

Figure 1. CEMT INQUIRE TASK screen

 IN TCLASS
 STATUS:  RESULTS - OVERTYPE TO MODIFY
  Tcl(DFHTCIND) Max( 010 ) Act(000) Pur( 0000000 )
     Que(000000)
  Tcl(DFHTCL01) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)
  Tcl(DFHTCL02) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)
  Tcl(DFHTCL03) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)
  Tcl(DFHTCL04) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)
  Tcl(DFHTCL05) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)
  Tcl(DFHTCL06) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)
  Tcl(DFHTCL07) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)
+ Tcl(DFHTCL08) Max( 001 ) Act(000) Pur( 0000000 )
     Que(000000)

If you place the cursor against a specific entry in the list and press ENTER, CICS displays an expanded format, as shown in Figure 2.

Figure 2. The expanded display of an individual entry

 IN TCLASS
 RESULT - OVERTYPE TO MODIFY
   Tclass(DFHTCIND)
   Maxactive( 010 )

CEMT INQUIRE TCLASS

Displayed fields

ACTIVE (value)

Displays the total number of transactions that are currently active in a user-defined transaction class.

CHANGEAGENT(value)

Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CREATESPI: The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI: The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH: The resource definition was last changed by a DFHCSDUP job.
DREPAPI: The resource definition was last changed by a CICSPlex SM BAS API command.

CHANGEAGREL(value)

Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(date time)

Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

CHANGEUSRID(value)

Displays the 8-character user ID that ran the change agent.

DEFINESOURCE(value)

Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.

DEFINETIME(date time)

Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

INSTALLAGENT(value)

Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CREATESPI: The resource was installed by an EXEC CICS CREATE command.
CSDAPI: The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST: The resource was installed by GRPLIST INSTALL.

INSTALLTIME(date time)

Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

INSTALLUSRID(value)

Displays the 8-character user ID that installed the resource.

MAXACTIVE (value)

Displays the largest number of transactions in the transaction class that are allowed to run concurrently. The value can be in the range 0 - 999.

You can reset this value by overtyping it with a different value.

PURGETHRESH (value)

Displays the limit at which the queuing transactions are purged for the transaction class. It can have a value in the range 0000000 - 1000000. Zero means that the transactions are not purged. A nonzero number n means that the first (n-1) transactions to arrive are queued and the nth is purged.

You can reset this value by overtyping it with a different value.

QUEUED (value)

Displays the total number of current tasks that are suspended because the class maximum has been reached.

TCLASS (value)

Indicates that this panel relates to a TCLASS inquiry and displays an 8-character transaction class name.