Return codes
UERCNORM
Continue processing.
XPI calls
XPI must not be used.
API and SPI calls
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.
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
transaction group ID and origin data, including the user correlator, to be
inherited by the mirror task in the target region.
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
At the attach of a non-system task that has no inherited Associated Data
Origin Descriptor data passed to it.
Exit-specific parameters
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.
Return codes
Chapter 1. Global user exit programs 33