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

将 IBM 大型机上的 IMS 程序与 Azure 逻辑应用 中的标准工作流集成

适用于:Azure 逻辑应用(标准)

若要从 Azure 逻辑应用 中的标准工作流访问和运行基于信息管理系统(IMS)系统的 IBM 大型机应用,可以使用基于 IMS 计划调用的内置基于服务提供商的连接器。 IMS 提供具有集成事务管理器(TM)和分层数据库的事务程序(TP)监视器。 连接器使用 IMS 连接(IMS TM 网络组件)与 IBM IMS 事务程序通信。 此组件为一个或多个 TCP/IP 客户端和一个或多个 IMS 系统之间的 IMS 系统提供高性能通信。 IMS 连接器在所有Azure 逻辑应用区域中可用,但由世纪互联运营的 Azure 政府 和 Microsoft Azure 除外。

本操作指南介绍了有关 IMS 连接器的以下方面:

  • 为何在 Azure 逻辑应用 中使用 IMS 连接器

  • 使用 IMS 连接器的先决条件和设置

  • 将 IMS 连接器操作添加到标准逻辑应用工作流的步骤

为何使用此连接器?

IMS 系统是大型机上运行的第一个任务关键型系统之一。 Microsoft Host Integration Server (HIS) 通过以下两种模型提供与 IMS 系统的连接:IMS 连接和 APPC LU6.2。 客户多年来一直使用 HIS 事务集成器(TI)将其 IMS 系统与本地 Windows 集成。 IMS 程序调用连接器使用 IMS 连接 模型通过 TCP/IP 与 IMS 事务程序交互。

下图显示了 IMS 连接器如何与 IBM 大型机系统交互:

Conceptual diagram shows how the IMS Program Call connector works with IBM mainframe system.

为了扩展这些混合云方案,标准工作流中的 IMS 连接器适用于 逻辑应用的 HIS 设计器,可用于创建 大型机事务程序的程序定义程序映射 。 对于此任务,HIS Designer 会将该信息转换为 IMS 连接器在工作流中运行操作时使用的元数据。

从 HIS Designer 生成元数据文件作为 Host Integration Designer XML (HIDX) 文件后,可以将该文件作为映射项目添加到标准逻辑应用资源。 这样,工作流就可以在添加 IMS 连接器操作时访问应用的元数据。 连接器从逻辑应用资源读取元数据文件,并动态显示要用于工作流中的 IMS 连接器的参数。 然后,可以向主机应用程序提供参数,连接器会将结果返回到工作流。 因此,可以将旧版应用与 azure、Microsoft、其他应用、服务和Azure 逻辑应用支持的系统集成。

连接器技术参考

以下部分介绍 IMS 连接器的操作,该连接器当前仅包含以下操作:

调用 IMS 程序

参数 必选 Type 描述
HIDX 名称 字符串 选择要使用的 IMS HIDX 文件。
“方法名称” 字符串 在要使用的 HIDX 文件中选择该方法。
高级参数 多种多样 选择方法后会显示此列表,以便添加其他参数以用于所选方法。 可用参数因 HIDX 文件和所选方法而异。

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

限制

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

先决条件

  • Azure 帐户和订阅。 如果没有 Azure 订阅,请注册一个免费 Azure 帐户

  • 访问托管 IMS 系统的大型机

  • 主机集成设计器 XML (HIDX) 文件,该文件为 IMS 程序调用连接器提供执行大型机程序所需的元数据

    若要创建此 HIDX 文件,请下载并安装 HIS Designer for Azure 逻辑应用。 唯一的必备组件是 Microsoft .NET Framework 4.8

    若要调用大型机程序,工作流需要了解大型机程序的类型、参数和返回值。 IMS 连接器管理过程和数据转换,从工作流向大型机程序提供输入数据以及将从大型机程序生成的任何输出数据发送到工作流所需的过程和数据转换。 连接器还提供表格数据定义和代码页转换。 对于此过程,Azure 逻辑应用要求将此信息作为元数据提供。

    若要创建此元数据,请使用 用于逻辑应用的 HIS 设计器。 借助此工具,可以手动创建可在工作流中使用的方法、参数和返回值。 该工具还允许导入提供此信息的 COBOL 或 RPG 程序定义(copybooks)。

    该工具生成主机集成设计器 XML (HIDX) 文件,该文件为连接器提供必要的元数据。 如果使用 HIS,可以使用 TI 设计器创建 HIDX 文件。

  • 用于与 IMS 系统集成的标准逻辑应用工作流

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

定义和生成元数据

下载并安装 HIS Designer for Azure 逻辑应用后,请按照以下步骤从元数据项目生成 HIDX 文件。

上传 HIDX 文件

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

  1. 转到保存 HIDX 文件的文件夹,并复制该文件。

  2. Azure 门户中,将 HIDX 文件作为映射上传到标准逻辑应用资源

  3. 现在, 将 IMS 操作添加到工作流

在本指南的后面部分,首次将 IMS 计划呼叫连接器操作添加到工作流时,系统会提示你在工作流和大型机系统之间创建连接。 创建连接后,可以选择以前添加的 HIDX 文件、要运行的方法以及要使用的参数。

添加 IMS 操作

  1. Azure 门户的设计器中,打开标准逻辑应用资源和工作流。

  2. 如果尚未添加用于启动工作流的触发器, 请按照以下常规步骤添加所需的触发器。

    此示例继续使用名为“收到 HTTP 请求时”的请求触发器。

    Screenshot shows Azure portal, Standard workflow designer, and Request trigger.

  3. 若要添加 IMS 连接器操作,请按照以下常规步骤添加名为“调用 IMS 计划”的 IMS 计划调用内置连接器操作。

  4. 显示连接详细信息窗格后,请提供以下信息:

    参数 必须 说明
    连接名称 <connection-name> 连接名称
    IMS 系统 ID <IMS-system-ID> IMS 连接模型定向传入请求的 IMS 系统的名称
    ITOC 退出名称 <ITOC-exit-name> IMS 用于处理传入请求的退出例程的名称
    MFS 模式名称 <MFS-Mod-Name> 与出站 IMS 消息输出描述符关联的名称
    使用 HWSO1 安全退出 判断对错 服务器使用 HWSO1 安全退出。
    服务器证书公用名 <server-cert-common-name> 要使用的传输安全层 (TLS) 证书的名称
    代码页 <code-page> 用于转换文本的代码页码
    密码 <password> 用于连接身份验证的可选用户密码
    端口号 <port-number> 用于连接身份验证的端口号
    服务器名称 <server-name> 服务器名称
    超时 <超时> 等待来自服务器的响应时超时期限(以秒为单位)
    用户名 <user-Name> 连接身份验证的可选用户名
    使用 TLS 判断对错 使用传输安全层(TLS)保护连接。
    验证服务器证书 判断对错 验证服务器的证书。

    例如:

    Screenshot shows IMS action's connection properties.

  5. 完成后,选择“ 新建”。

  6. 操作详细信息窗格出现后,在“ 参数 ”部分中提供所需的信息:

    参数 必须 说明
    HIDX 名称 <HIDX-file-name> 选择要使用的 IMS HIDX 文件。
    “方法名称” <method-name> 在要使用的 HIDX 文件中选择该方法。
    高级参数 多种多样 选择方法后会显示此列表,以便添加其他参数以用于所选方法。 可用参数因 HIDX 文件和所选方法而异。

    例如:

    选择 HIDX 文件和方法

    Screenshot shows IMS action with selected HIDX file and method.

    选择高级参数

    Screenshot shows IMS action with all parameters.

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

测试工作流

  1. 若要运行工作流,请在工作流菜单上选择“ 概述”。 在“概述”工具栏上,选择“运行”>“运行”。

    工作流完成运行后,将显示工作流的运行历史记录。 成功的步骤显示检查标记,而不成功的步骤显示感叹号()。

  2. 若要查看每个步骤的输入和输出,请展开该步骤。

  3. 若要查看输出,请选择“查看原始输出”。

后续步骤