Response and reason values for inquire_transaction, The set_transaction call – IBM SC34-6814-04 User Manual

Page 440

Advertising
background image

TRANNUM(name4)

returns the task number of the transaction.

name4

The name of a 4-byte location to receive the task number.

TRANSACTION_TOKEN(name8)

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.

USERID(name8)

returns the userid associated with this task.

name8

The name of an 8-byte location to receive the userid.

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

This command is threadsafe.

418

Customization Guide

Advertising