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

This command is threadsafe.

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.

RESPONSE and REASON values for SET_TRANSACTION

RESPONSE	REASON
OK	None
EXCEPTION	NO_TRANSACTION_ENVIRONMENT
	UNKNOWN_TCLASS
	INVALID_TRANSACTION_TOKEN
DISASTER	ABEND
	LOOP
INVALID	None
KERNERROR	None