The set_transaction call, Response and reason values for inquire_transaction – IBM SC33-1683-02 User Manual

Page 419

Advertising
background image

RESPONSE and REASON values for INQUIRE_TRANSACTION:

RESPONSE

REASON

OK

None

DISASTER

ABEND
LOOP

INVALID

None

EXCEPTION

NO_TRANSACTION_ENVIRONMENT
BUFFER_TOO_SMALL
INVALID_TRANSACTION_TOKEN

KERNERROR

None

The SET_TRANSACTION call

The SET_TRANSACTION function is provided on the DFHXMIQX macro call. Its
purpose is to allow you to change the task priority and transaction class of the
current task.

Note that you can use this call to change the TCLASS_NAME only when it is
invoked from an XXMATT global user exit program.

SET_TRANSACTION

DFHXMIQX [CALL,]

[CLEAR,]

[IN,

FUNCTION(SET_TRANSACTION),

[TASK_PRIORITY(name4),]

[TCLASS_NAME(name8),]

[TRANSACTION_TOKEN(name8),]]

[OUT,

RESPONSE (name1 | *),

REASON (name1 | *)]

TASK_PRIORITY(name4)

specifies the new task priority being set for the task identified by
TRANSACTION_TOKEN.

name4

The name of a 4-byte location that contains the new task priority
number, expressed as a binary value.

TCLASS_NAME(name8)

specifies the new transaction class name that you want to associate this task
with. To specify that the task is not to be in any transaction class, specify the
special default system name DFHTCL00.

name8

The name of an 8-byte location that contains the name of the new
transaction class. Set this field to DFHTCL00 for no transaction class.

TRANSACTION_TOKEN(name8)

specifies the transaction token that represents the task being modified. If you
omit this parameter, the call defaults to the current task.

name8

The name of an 8-byte location that contains the transaction token.

transaction management functions

Chapter 3. The user exit programming interface (XPI)

387

Advertising