Application Associated Data Exit, Xapadmgr, In The Ap Domain - IBM SC34-6814-04 Customization Manual

Return codes
XPI calls
API and SPI calls

Application Associated Data exit, XAPADMGR, in the AP domain

Use the XAPADMGR exit for distributed transactions. It allows you to add user
information to a task's Associated Data Origin Descriptor, at the point of origin of the
distributed transaction. This information could later be used as, for example, search
keys for processing carried out through CICSPlex SM.
The exit program is invoked, if enabled, at the attach of non-system tasks for which
no input Origin Descriptor Record is provided.
On input, the exit program is passed the task's association data. It could find other
relevant information, for inclusion in the Associated Data Origin Descriptor, from
other sources, using CICS commands.
Note: Distributed transactions that use DPL over IPIC connections pass their
The exit program could perform other activities, such as logging of information
found in the association data, for purposes such as auditing or accounting of
workloads.
Exit XAPADMGR
When invoked
Exit-specific parameters
Return codes
UERCNORM
Continue processing.
XPI must not be used.
The following commands are supported:
v ADDRESS CWA
v ADDRESS EIB
v LINK (but only to local programs; distributed program links may not be
used).
v RETURN
v WRITE JOURNALNAME.
transaction group ID and origin data, including the user correlator, to be
inherited by the mirror task in the target region.
At the attach of a non-system task that has no inherited Associated Data
Origin Descriptor data passed to it.
UEPADCB
Address of the selectable association data control block. This is
mapped by the DFHMNADS DSECT.
UEPADCBL
Length, in bytes, of the associated data control block.
UEPUCD
Address of a 64-byte output area in which the exit program can
place the user correlation data.
Chapter 1. Global user exit programs
33