The inquire_tclass call – IBM SC33-1683-02 User Manual

Page 406

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 | *)]

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.

transaction management functions

374

CICS TS for OS/390: CICS Customization Guide

Advertising