Application association data exit in the AP domain (XAPADMGR)

Use the XAPADMGR exit for distributed transactions. XAPADMGR allows you to add user information to the association data of a task, at the point of origin of the distributed transaction. This information could be used later, for example, as a search key for processing carried out through CICSPlex® SM.

The exit program is called, if enabled, at the attach of nonsystem tasks for which no input Origin Descriptor Record is provided.

On input, the exit program is passed the association data of the task. The exit might find other relevant information, for inclusion in the association data, 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. For more information on association data and origin data, see Association data.

Exit XAPADMGR

When called
At the attach of a nonsystem task that has no inherited association 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 association data control block.
UEPUCD
Address of a 64-byte output area in which the exit program can place the user correlation data.

This area will be cleared to zeros by CICS before invoking the first exit program that is active in the XAPADMGR user exit point, but will not be reset by CICS between programs if multiple exit programs are active. The same storage area will be passed to subsequent exit programs that are active in the same exit point.

Return codes
UERCNORM
Continue processing.
XPI calls
All can be used.
API and SPI calls
All can be used, except for:
  • EXEC CICS ABEND
  • EXEC CICS PERFORM SHUTDOWN

Sample exit program

DFH$APAD