你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 IBM 中级系统上的 COBOL 和 RPG 程序与 Azure 逻辑应用中的标准工作流集成

2025-04-19

适用于：Azure 逻辑应用（标准）

若要从 Azure 逻辑应用中的标准工作流访问和运行 IBM midrange 系统上的 COBOL 和 RPG 程序，可以使用基于服务提供商的内置 IBM i Program Call 连接器。 IBM i作系统提供分布式程序调用（DPC）服务器。连接器与 IBM i DPC 服务器通信，以使用 TCP/IP 执行 COBOL 和 RPG 程序。 IBM i 连接器适用于除 Azure 美国政府版和由世纪互联运营的 Microsoft Azure 之外的所有 Azure 逻辑应用区域。

本文介绍 IBM i 连接器的以下方面：

在 Azure 逻辑应用中使用 IBM i 连接器的方案
使用 IBM i 连接器的先决条件和设置
将 IBM i 连接器操作添加到标准逻辑应用工作流的步骤

查看连接器使用场景

50多年前，IBM发布了第一个中型系统。 IBM将其宣传为“大小小，价格小，性能大。这是一个适用于当前和未来的系统。多年来，中型系统不断发展，在中型企业或大型企业中普及，以扩展大型机环境。运行 IBM i（通常是 Power Systems）的 Midrange 系统支持 TCP/IP 和 SNA。

IBM i 系统包括 DPC 服务器功能，它允许大多数 IBM i 应用程序使用客户端启动的仅请求回复模式和最小修改来与 Azure 逻辑应用等客户端进行交互。 DPC 是一种记录的协议，支持 IBM i 系统上的程序到程序集成，客户端应用程序可以使用 TCP/IP 网络协议轻松访问它。

Microsoft Host Integration Server （HIS）使用 TCP/IP 和 APPC LU6.2 提供与 IBM i 系统的连接。多年来，客户已使用 HIS 事务集成器来集成本地 IBM i 系统和 Windows。 IBM i Program Call 连接器使用 TCP/IP 编程模型与 IBM i COBOL 和 RPG 程序进行交互。

下图显示了 IBM i 连接器如何与 IBM i 系统交互：

为了扩展这些混合云方案，标准工作流中的 IBM i 连接器适用于逻辑应用的 HIS 设计器，可用于创建 COBOL 或 RPG 程序 的程序定义 或 程序映射 。对于此任务，HIS Designer 使用一个编程模型来确定中间区域和工作流之间数据交换的特征。 HIS Designer 将该信息转换为 IBM i 连接器在执行工作流中的操作时使用的元数据。

通过 HIS 设计器生成元数据文件作为主机集成设计器 XML (HIDX) 文件后，可以将该文件作为映射项目添加到标准逻辑应用资源。这样，在添加 IBM i 连接器操作时，工作流就可以访问应用的元数据。连接器从逻辑应用资源中读取元数据文件，并动态地显示要在工作流与 IBM i 连接器一起使用的参数。然后，可将参数提供给主机应用程序，而连接器会将结果返回给工作流。因此，你可以将旧版应用与 Azure、Microsoft，以及 Azure 逻辑应用支持的其他应用、服务和系统相集成。

连接器技术参考

目前，IBM i 连接器可以使用一个操作：调用 IBM i 程序。下表汇总了此操作的用法：

参数	必选	类型	DESCRIPTION
HIDX 名称	是的	字符串	选择要使用的 IBM i HIDX 文件。
方法名称	是的	字符串	选择要使用的 HIDX 文件中的方法。
高级参数	否	多种多样	选择方法后会显示此列表，以便添加其他参数来用于所选方法。可用参数因 HIDX 文件和所选方法而异。

此操作还包括在选择方法后显示的高级参数，供你选择并与所选方法配合使用。这些参数因 HIDX 文件和所选方法而异。

先决条件

Azure 帐户和订阅。如果没有 Azure 订阅，请注册一个免费 Azure 帐户。
访问托管 IBM i 系统的中型机服务器。
主机集成设计器 XML (HIDX) 文件，为 IBM i Program Call 连接器提供执行中端程序所需的元数据。

若要创建此 HIDX 文件，请下载并安装适用于 Azure 逻辑应用的 HIS 设计器。唯一的必备组件是 Microsoft .NET Framework 4.8。

若要调用 midrange 程序，工作流需要了解 midrange 程序的类型、参数和返回值。 IBM i 连接器管理此过程和数据转换。这些必需的转换提供从工作流到中程程序的输入数据，并将中程程序生成的任何输出数据发送回工作流。该连接器还提供表格数据定义和代码页转换。对于此过程，Azure 逻辑应用要求将此信息作为元数据提供。

若要创建此元数据，请使用用于逻辑应用的 HIS 设计器。借助此工具，可以手动创建在工作流中使用的方法、参数和返回值。还可以导入提供此信息的 COBOL 或 RPG 程序定义文件（副本书）。

该工具会生成一个主机集成设计器 XML (HIDX) 文件，该文件提供连接器在所需的元数据。如果使用 HIS，可以使用 HIS 事务集成器 (TI) 设计器创建 HIDX 文件。
要与 IBM i 系统集成的标准逻辑应用工作流。

IBM i 连接器没有触发器，因此请使用任何触发器启动工作流，例如定期触发器或请求触发器。然后，可以添加 IBM i 连接器操作。若要开始，请在标准逻辑应用资源中创建一个空白工作流。

局限性

目前，IBM i 连接器要求将 HIDX 文件直接上传到标准逻辑应用资源，而不是集成帐户。

定义和生成元数据

下载并安装用于 Azure 逻辑应用的 HIS 设计器后，请按照这些步骤从元数据项目生成 HIDX 文件。

上传 HIDX 文件

若要使工作流使用 HIDX 文件，请执行以下步骤：

转到保存 HIDX 文件的文件夹并复制该文件。
在 Azure 门户中，打开你的标准逻辑应用资源。
在逻辑应用菜单上的“制品”下，将 HIDX 文件作为映射上传到逻辑应用资源中。
继续到下一部分，将 IBM i 动作添加到您的工作流中。

在本指南的后面部分，当您首次将 IBM i Program Call 连接器动作添加到工作流中时，系统会提示您创建工作流与中程系统之间的连接。创建连接后，可以选择前面添加的 HIDX 文件、要运行的方法以及要使用的参数。

添加 IBM i 操作

按照以下步骤添加 IBM i 操作并配置必要的参数：

在 Azure 门户的设计器中，打开标准逻辑应用资源和工作流。
如果没有用于启动工作流的触发器，请按照以下常规步骤添加所需的触发器。

此示例继续使用名为“收到 HTTP 请求时”的请求触发器：
若要添加 IBM i 连接器操作，请按照以下常规步骤添加名为“调用 IBM i 程序”的 IBM i 程序 内置连接器操作。

显示连接详细信息窗格后，提供以下信息，例如主机服务器名称和 IBM i 系统配置信息：

参数	必选	价值	DESCRIPTION
连接名称	是的	<connection-name>	连接的名称。
服务器证书公用名称	否	<服务器证书通用名称 (server-cert-common-name)>	要使用的传输安全层 (TLS) 证书的名称。
代码页	否	<code-page>	用于转换文本的代码页码。
密码	否	<密码>	用于连接身份验证的可选用户密码。
端口号	是的	<port-number>	用于连接身份验证的端口号。
服务器名称	是的	<server-name>	服务器名称
超时	否	<超时>	等待服务器响应的超时时间（以秒为单位）。
用户名	否	<user-name>	用于连接身份验证的可选用户名。
使用 TLS	否	真或假	使用传输安全层 (TLS) 保护连接。
验证服务器证书	否	真或假	验证服务器证书。

例如：

完成后，选择“新建”。

出现操作详细信息窗格后，在“参数”部分中提供所需信息：

参数	必选	价值	DESCRIPTION
HIDX 名称	是的	<HIDX-file-name>	选择要使用的 IBM i HIDX 文件。
方法名称	是的	<method-name>	选择要使用的 HIDX 文件中的方法。
高级参数	否	多种多样	选择方法后会显示此列表，以便添加其他参数来用于所选方法。可用参数因 HIDX 文件和所选方法而异。

例如：

选择 HIDX 文件和方法

选择高级参数

完成后，保存工作流。在设计器工具栏上选择“保存”。

测试工作流

按照以下步骤检查工作流并确认输出：

要运行工作流，请在设计器工具栏中选择“运行”“运行”。>

工作流完成运行后，将显示工作流的运行历史记录。步骤成功后会显示勾选标记，步骤失败则会显示感叹号 (!)。
若要查看每个步骤的输入和输出，请展开该步骤。
若要查看输出，请选择“查看原始输出”。