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

Page 415: Transaction management functions

Advertising
background image

(Rn)

A register to receive the size of the transaction work area, expressed as
a binary value.

RESPONSE and REASON values for INQUIRE_TRANDEF:

RESPONSE

REASON

OK

None

EXCEPTION

UNKNOWN_TRANSACTION_ID

INVALID

None

DISASTER

LOGIC_ERROR

PURGED

None

The INQUIRE_TRANSACTION call

The INQUIRE_TRANSACTION function is provided on the DFHXMIQX macro call.
Its purpose is to allow you to obtain information about a transaction that is attached
(task). In general, this call is equivalent to the EXEC CICS INQUIRE TASK
command, with some minor differences.

INQUIRE_TRANSACTION

DFHXMIQX [CALL,]

[CLEAR,]

[IN,

FUNCTION(INQUIRE_TRANSACTION),

[TRANSACTION_TOKEN(name8),]]

[OUT,

[ATTACH_TIME(name8),]

[CICS_UOW_ID(name8),]

[DTIMEOUT(name4 | (Rn)),]

[DYNAMIC(name1),]

[FACILITY_NAME(name4),]

[FACILITY_TYPE(name1),]

[INITIAL_PROGRAM(name8),]

[NETNAME(name8),]

[ORIGINAL_TRANSACTION_ID(name4),]

[OUT_TRANSACTION_TOKEN(name8),]

[RE_ATTACHED_TRANSACTION(name1),]

[REMOTE(name1),]

[REMOTE_NAME(name8),]

[REMOTE_SYSTEM(name4),]

[RESOURCE_NAME(name8),]

[RESOURCE_TYPE(name8),]

[RESTART(name1),]

[RESTART_COUNT(name2 | (Rn)),]

[SPURGE(name1),]

[START_CODE(name1),]

[STATUS(name1),]

[SUSPEND_TIME(name4 | (Rn)),]

[SYSTEM_TRANSACTION(name1),]

[TASK_PRIORITY(name1),]

[TCLASS(name1),[TCLASS_NAME(name8),]]

[TPURGE(name1),]

[TRANNUM(name4 | string | ‘string’),]

[TRAN_PRIORITY(name1),]

[TRAN_ROUTING_PROFILE(name8),]

[TRANSACTION_ID(name4),]

[USERID(name8),]

RESPONSE (name1 | *),

REASON (name1 | *)]

transaction management functions

Chapter 3. The user exit programming interface (XPI)

383

Advertising