The inquire_tclass call – IBM SC34-6814-04 User Manual

Page 427

Advertising
background image

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.

Chapter 3. The user exit programming interface (XPI)

405

Advertising