The INQUIRE_TCLASS call

The INQUIRE_TCLASS function is provided on the DFHXMCLX macro call. Its purpose is to provide current information about the specified transaction class (TCLASS).

INQUIRE_TCLASS

DFHXMCLX  [CALL,]
       [CLEAR,]
       [IN,
       FUNCTION(INQUIRE_TCLASS),
       INQ_TCLASS_NAME(name8 | string | ‘string’),]
       [OUT,
       [CURRENT_ACTIVE(name4 | (Rn)),]
       [CURRENT_QUEUED(name4 | (Rn)),]
       [MAX_ACTIVE(name4 | (Rn)),]
       [PURGE_THRESHOLD(name4 | (Rn)),]
       RESPONSE (name1 | *),
       REASON (name1 | *)]

This command is threadsafe.

CURRENT_ACTIVE(name4 | (Rn))

returns the current number of active user tasks in this transaction class.

name4: The name of a 4-byte location that is to receive the current number of active user tasks for this transaction class, expressed as a binary value.
(Rn): A register to receive the current number of active user tasks for this transaction class, expressed as a binary value.

CURRENT_QUEUED(name4 | (Rn))

returns the current number of queued user tasks.

name4: The name of a 4-byte location that is to receive the current number of queued user tasks in this transaction class, expressed as a binary value.
(Rn): A register to receive the current number of queued user tasks, expressed as a binary value.

INQ_TCLASS_NAME(name8 | string | ‘string’)

specifies the name of the transaction class for this inquiry.

name8: The name of an 8-byte location that contains the name of the transaction class being inquired on.
string: A string of characters, without intervening blanks, naming the transaction class.
‘string’: A string of characters, within quotation marks, naming the transaction class. The string length is set to 8 by padding with blanks within the quotation marks.

MAX_ACTIVE(name4 | (Rn))

returns the current maximum number of active tasks allowed for the transaction class.

name4: The name of a 4-byte location that is to receive the current maximum number of active tasks currently allowed for this transaction class, expressed as a binary value.
(Rn): A register to receive the current maximum number of active tasks currently allowed for this transaction class, expressed as a binary value.

PURGE_THRESHOLD(name4 | (Rn))

returns the purge threshold limit for this transaction class.

name4: The name of a 4-byte location that is to receive the current purge threshold limit for this transaction class, expressed as a binary value.
(Rn): A register to receive the current purge threshold limit for this transaction class, expressed as a binary value.

RESPONSE and REASON values for INQUIRE_TCLASS

RESPONSE	REASON
OK	None
DISASTER	LOGIC_ERROR
INVALID	None
EXCEPTION	UNKNOWN_CLASS