AP 域中的应用程序关联数据出口 (XAPADMGR)
针对分布式事务使用 XAPADMGR 出口。 XAPADMGR 允许您在分布式事务的起点，将用户信息添加到任务的关联数据中。 此信息稍后可用作通过 CICSPlex ® SM 执行的处理的搜索键。
如果启用了出口程序，那么将在未提供输入源描述符记录的非系统任务的连接上调用该出口程序。
在输入时，将向出口程序传递任务的关联数据。 出口可能会使用 CICS® 命令从其他源中找到其他相关信息以包含在关联数据中。
注: 通过 IPIC 连接使用 DPL 的分布式事务会传递其事务组标识和原始数据 (包括用户相关因子) ，以供目标区域中的镜像任务继承。
出口程序可以执行其他活动，例如记录在关联数据中找到的信息，以用于审计或记帐工作负载。 有关关联数据和原始数据的更多信息，请参阅 关联数据。
退出 XAPADMGR
- 调用时
- 在连接未向其传递继承关联数据的非系统任务时。
- 特定于出口的参数
- UEPADCB
- 可选择的关联数据控制块的地址。 这是由 DFHMNADS DSECT 映射的。
- UEPADCBL
- 关联数据控制块的长度 (以字节计)。
- UEPUCD
- 出口程序可在其中放置用户相关数据的 64 字节输出区域的地址。
在调用 XAPADMGR 用户出口点中处于活动状态的第一个出口程序之前， CICS 会将此区域清除为零，但如果多个出口程序处于活动状态，那么 CICS 不会在程序之间重置此区域。 同一存储区域将传递到在同一出口点中处于活动状态的后续出口程序。
- 返回码
- UERCNORM
- 继续处理。
- XPI 调用
- 都可以用。
- API 和 SPI 调用
- 所有都可以使用，但以下情况除外:
- EXEC CICS ABEND
- EXEC CICS PERFORM SHUTDOWN