DFHECALL 宏

CICS® 转换程序为汇编语言 CICS 应用程序中的每个 EXEC CICS 命令生成此宏的调用。

语法

读取语法图跳过可视语法图DFHECALL

描述

对于汇编语言应用程序,当 CICS 转换程序检测到 CICS 命令时,会通过调用 DFHECALL 宏来替换每条命令。 DFHECALL 宏用于设置命令参数并调用初始 CICS 命令处理器来处理命令。

此宏扩展为使用寄存器 15,14 , 0 和 1 的系统标准调用序列。 这些寄存器的内容如下:
  • 寄存器 15 包含 EXEC 接口程序中入口点的地址。
  • 寄存器 14 包含应用程序中返回点的地址。
  • 未定义寄存器 0。
  • 寄存器 1 包含参数列表的地址。
在 EXEC 接口处理器中解析了寄存器 15 中的入口点,该入口点必须与应用程序进行链接编辑。
  • 对于 AMODE (24) 和 AMODE (31) 应用程序,此 EXEC 接口处理器为 DFHEAI。
  • 对于 AMODE (64) 应用程序,此 EXEC 接口处理器是 DFHEAG。

您可以通过源程序中的 EXEC CICS RETURN 命令指定应用程序的出口。 或者,您可以使用 DFHEIRET 宏,这将恢复寄存器并将控制权返回到寄存器 14 中的地址。 除非指定 NOEPILOG 转换程序选项,否则转换程序会在 END 语句之前立即插入 DFHEIRET 宏 (未指定任何参数)。 您可以使用此宏从顶级程序返回,但建议不要从较低级别的程序返回。

在组装期间, DFHECALL 宏会在动态存储器中构建参数列表,以便应用程序可重入。 然后,宏调用针对 AMODE (24) 或 AMODE (31) 应用程序的 EXEC 接口程序 DFHEIP ,或针对 AMODE (64) 应用程序的 DFHEIG。 这些程序也服从系统标准,如前所述。

对于 AMODE (64) 应用程序,虽然应用程序和初始命令处理器以 64 位寻址方式运行,但 DFHECALL 宏设置并传递到初始命令处理器的参数包含 31 位地址。 因此,在其中构建调用参数的存储器 (DFHEISTG 存储器) 必须是 31 位存储器 (高于 16 MB 但低于 2 GB)。

操作数

此宏没有任何操作数。