退出 XRMIOUT
在处理 RMI API 请求时返回与任务相关的用户出口程序之后,将调用出口 XRMIOUT。
特定于出口的参数
- UEPTR袁
- 与任务相关的用户出口程序的名称的地址。
- UEPTRUEP
- 要传递到与任务相关的用户出口程序的参数列表的地址。
此参数列表中的 UEPHMSA 参数包含调用者的寄存器保存区域 (RSA)。 对于 EXEC CPSM 调用,在此 RSA 中注册 1 包含 CICSPlex ® SM 命令的参数列表的地址,并且可用于标识 CICSPlex SM 命令和指定的资源。 有关详细信息,请参阅 CICSPlex SM API 命令参数列表。
- UEP_RM_PBTOK
- 包含 z/OS® 工作负载管理器 (WLM) 性能块令牌的 4 字节字段的地址。 出口程序可以使用此令牌来访问 WLM 性能块中的信息 (例如服务类令牌 SERVCLS)。 为此,它必须使用 WLM EXTRACT 宏 IWMMEXTR ,传递性能块令牌作为 MONTKN 输入参数。 有关 IWMMEXTR 宏的更多信息,请参阅 z/OS MVS Programming: Workload Management Services。
出口程序不得尝试修改性能块: 如果执行此操作,那么结果不可预测。
- UEPRECUR
- 半字递归计数器的地址。 当第一次调用出口时,计数器设置为 0 ,并针对每个递归调用递增。
注: 与任务相关的用户出口程序的参数列表由 DFHUEPAR DSECT 映射,该 DFHUEPAR DSECT 与全局用户出口程序的 DFHUEPAR 参数列表共享公共字段名称。 要在出口程序中包含这两个 DSECT 定义,必须编写以下代码:必须按此顺序对语句进行编码。
DFHUEXIT TYPE=EP,ID=XRMIOUT
DFHUEXIT TYPE,TYPE=RM全局用户出口的 DFHUEPAR 参数列表和与任务相关的用户出口的 DFHUEPAR 参数列表各自占用单独的存储区域。 提供与任务相关的用户出口的参数列表仅供参考; 请勿以任何方式对其进行修改。
返回码
- UERCNORM
- 继续处理。
- UERCPURG
- 在 XPI 调用期间清除了任务。
XPI 调用
都可以用。
API 和 SPI 命令
可以使用除 EXEC CICS SHUTDOWN 和 EXEC CICS XCTL 之外的所有其他内容。 但是, 不得 使用 CALLDLI , EXEC DLI 或 EXEC SQL 命令。
注: 建议出口程序不要对使用 RMI 的其他外部资源管理器进行调用,因为这会导致递归,并可能导致循环。 出口程序负责避免进入循环。 您可以在出口程序中使用递归计数器字段 UEPRECUR 来防止这种可能性。