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

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

要从 Azure 逻辑应用中的标准工作流访问和运行信息管理系统 (IMS) 系统上的 IBM 大型机应用，可以使用 IMS 程序调用内置的基于服务提供商的连接器。 IMS 提供具有集成事务管理器 (TM) 和分层数据库的事务程序 (TP) 监视器。 连接器使用 IMS Connect（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 Connect 和 APPC LU6.2。 客户多年来一直使用 HIS 事务集成器将其 IMS 系统与本地 Windows 集成。 IMS 程序调用连接器使用 IMS Connect 模型通过 TCP/IP 与 IMS 事务程序进行交互。

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

为拓展这些混合云应用场景，在标准工作流中，IMS 连接器可与 HIS 逻辑应用设计器配合使用，你可利用该设计器创建针对大型机事务程序的程序定义或程序映射。 对于此任务，HIS 设计器将该信息转换为 IMS 连接器在工作流中运行操作时使用的元数据。

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

连接器技术参考

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

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

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

先决条件

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

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

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

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

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

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

  该工具会生成一个主机集成设计器 XML (HIDX) 文件，该文件提供连接器在所需的元数据。 如果使用 HIS，可以使用 HIS 事务集成器 (TI) 设计器创建 HIDX 文件。

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

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

局限性

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

定义和生成元数据

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

上传 HIDX 文件

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

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

2. 在 Azure 门户中，将 HIDX 文件作为映射到标准逻辑应用资源。

3. 继续下一部分，向工作流添加 IMS 操作。

在本文的稍后部分，首次向工作流添加 IMS 程序调用连接器操作时，系统会提示你在工作流和大型机系统之间创建连接。 创建连接后，可以选择前面添加的 HIDX 文件、要运行的方法以及要使用的参数。

添加 IMS 操作

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

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

2. 如果没有用于启动工作流的触发器，请按照这些步骤添加想要的触发器。

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

   

3. 若要添加 IMS 连接器操作，请按照这些步骤添加名为“调用 IMS 程序”的“IMS 程序调用”的内置连接器操作。

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

   参数	必选	价值	DESCRIPTION
   连接名称	是的	<connection-name>	连接的名称。
   IMS 系统 ID	是的	<IMS-system-ID>	IMS Connect 模型定向传入请求的 IMS 系统的名称。
   ITOC 退出名称	否	<ITOC-exit-name>	IMS 用于处理传入请求的退出例程的名称。
   MFS 模式名称	否	<MFS-Mod-Name>	与出站 IMS 消息输出描述符关联的名称。
   使用 HWSO1 安全退出	否	True 或 False	指示服务器使用 HWSO1 安全退出。
   服务器证书公用名称	否	<server-cert-common-name>	要使用的传输安全层 (TLS) 证书的名称。
   代码页	否	<code-page>	用于转换文本的代码页码。
   密码	否	<password>	用于连接身份验证的可选用户密码。
   端口号	是的	<port-number>	用于连接身份验证的端口号。
   服务器名称	是的	<server-name>	服务器名称。
   超时	否	<time-out>	等待服务器响应的超时时间（以秒为单位）。
   用户名	否	<user-Name>	用于连接身份验证的可选用户名。
   使用 TLS	否	True 或 False	使用传输安全层 (TLS) 保护连接。
   验证服务器证书	否	True 或 False	验证服务器证书。

   例如：

   

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

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

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

   例如：

   选择 HIDX 文件和方法

   

   选择高级参数

   

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

测试工作流

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

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

   工作流完成运行后，将显示工作流的运行历史记录。 步骤成功后会显示勾选标记，步骤失败则会显示感叹号 (!)。

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

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

相关内容

• 监控工作流状态、查看运行历史记录，并在 Azure 逻辑应用中设置警报
• 查看 Azure 逻辑应用中工作流运行状况和性能的指标
• 监视和收集 Azure 逻辑应用中工作流的诊断数据
• 在 Azure 逻辑应用中启用和查看 Application Insights 中标准工作流的增强遥测数据