BPE 初始化-终止用户提供的出口例程

BPE 初始化-终止用户提供的出口例程是在 BPE 初始化和正常 BPE 终止期间调用的。

BPE 用户出口例程使您能够定制和监视在基本原始环境上构建的地址空间。 BPE 定义的用户出口例程类型可用于与 BPE 一起运行的所有 IMS 组件地址空间。 编写这些出口例程。 未提供样本出口例程。 BPE 用户出口例程在处于授权状态的地址空间中被授予控制权。

建议: 使用汇编程序而不是高级语言编写 BPE 用户出口例程。 BPE 不支持在 Language Environment® for z/OS® 下运行的退出例程。如果您用高级语言编写退出例程,而该例程在 Language Environment for z/OS 中运行,则可能会出现中止或性能问题。 Language Environment for z/OS 是为在关键 8 问题程序状态下运行的应用程序设计的。 BPE 用户出口例程在密钥 7 管理程序状态下执行。
本主题包含产品敏感编程接口信息。

子节:

关于此例程

在 BPE 异常终止期间,不会调用 "初始化期限" 出口例程。 此出口例程是可选的。

在 BPE 出口例程的 EXITMBR 语句所指向的 BPE 用户出口 PROCLIB 成员的 EXITDEF 语句中, "初始化术语" 出口例程定义为 TYPE = INITTERM , COMP=BPE。 可以指定此类型的一个或多个用户出口例程。 当到达 init-term 出口点时,将按照 EXITS= 关键字指定的顺序来驱动出口例程。

建议: 编写 Init-Term 出口例程,使其可重入。 调用 Init-Term 出口例程的是 AMODE 31。

条目上的寄存器内容

注册
目录
1
标准 BPE 用户出口参数列表的地址 (由 BPEUXPL 宏映射)。
13
两个预先链接的保存区域的地址。 第一个保存区域可由出口例程用于在进入时保存寄存器。 第二个保存区域可由从用户出口例程调用的例程使用。
14 日
返回地址。
15 日
出口例程的入口点。

出口上寄存器的内容

注册
目录
15 日
返回码
0
始终将此值设置为零。

必须恢复所有其他寄存器。

BPE 初始化和终止参数列表

在进入 Init-Term 出口例程时, R1 指向标准 BPE 用户出口参数列表。 此列表中的字段 UXPL_EXITPLP 包含 Init-Term 用户出口例程参数列表 (由 BPEITXP 宏映射) 的地址。 下表提供了有关 BPE Init-Term 用户出口例程参数的以下信息:

  • 字段名称
  • 偏移量
  • 长度
  • 字段使用情况
  • 字段的描述
字段名称 偏移量 长度 字段使用情况 描述
BPEITXP X'00' 不适用 不适用 BPE init-term 出口参数列表的 DSECT 标签
bpeitxp_version X'00' X'04' 输入 参数列表版本号 (X'00000001 ')
BPEITXP_FUNC X'04' X'04' 输入 功能代码
1
BPE 初始化 (BPEITXP_FUNC_INIT)
2
BPE 终止 (BPEITXP_FUNC_TERM)