The Set_Transaction Call - IBM SC34-6814-04 Customization Manual

TRANNUM(name4)
TRANSACTION_TOKEN(name8)
USERID(name8)
RESPONSE and REASON values for INQUIRE_TRANSACTION:
RESPONSE
OK
DISASTER
INVALID
EXCEPTION
KERNERROR

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,]
This command is threadsafe.
418
Customization Guide
returns the task number of the transaction.
name4
The name of a 4-byte location to receive the task number.
specifies the transaction token for the task being inquired upon. This parameter
is optional, and if omitted, the current task is assumed.
If you issue this call within an XXMATT global user exit program, the current
task may be a CICS system task. To inquire on the user task for which
XXMATT is invoked, you must specify the transaction token passed on the
XXMATT exit-specific parameter list.
name8
The name of an 8-byte location that contains the transaction token.
returns the userid associated with this task.
name8
The name of an 8-byte location to receive the userid.
[CLEAR,]
[IN,
FUNCTION(SET_TRANSACTION),
[TASK_PRIORITY(name4),]
[TCLASS_NAME(name8),]
[TRANSACTION_TOKEN(name8),]]
[OUT,
RESPONSE (name1 | *),
REASON (name1 | *)]
REASON
None
ABEND
LOOP
None
NO_TRANSACTION_ENVIRONMENT
BUFFER_TOO_SMALL
INVALID_TRANSACTION_TOKEN
None