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

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

若要从 Azure 逻辑应用中的标准工作流访问和运行客户信息控制系统（CICS）系统上的 IBM 大型机应用，可以使用 CICS 计划调用 内置基于服务提供商的连接器。 CICS 提供具有集成事务管理器（TM）的事务程序（TP）监视器。 连接器使用 TCP/IP 与 IBM CICS 事务程序通信。 CICS 连接器适用于所有 Azure 逻辑应用区域，但不包括 Azure 政府版和由世纪互联运营的 Microsoft Azure。

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

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

审查连接器使用场景

CICS 系统是大型机上运行的第一个任务关键型系统之一。 Microsoft Host Integration Server （HIS） 使用 TCP/IP、HTTP 和 APPC LU6.2 与 CICS 系统建立连接。 客户多年来一直使用 HIS 事务集成器将 CICS 系统与本地 Windows 集成。 CICS 程序调用连接器使用 TCP/IP 和 HTTP 编程模型与 CICS 事务程序交互。

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

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

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

连接器技术参考

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

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

先决条件

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

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

• 主机集成设计器 XML （HIDX） 文件，该文件为 CICS 程序调用 连接器提供执行大型机程序所需的元数据。

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

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

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

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

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

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

局限性

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

定义和生成元数据

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

上传 HIDX 文件

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

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

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

3. 继续到下一部分，将 CICS 操作添加到工作流中。

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

添加 CICS 操作

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

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

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

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

   

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

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

   参数	必选	价值	Description
   连接名称	是的	< 连接名称>	连接的名称。
   编程模型	是的	< CICS编程模型>	选定的 CICS 编程模型。 有关详细信息，请参阅 编程模型。
   代码页	否	< code-page>	用于转换文本的代码页码。
   密码	否	< 密码>	用于连接身份验证的可选用户密码。
   端口号	是的	< port-number>	用于连接身份验证的端口号。
   服务器名称	是的	< server-name>	服务器名称
   超时	否	< 暂停>	等待来自服务器的响应时超时期限（以秒为单位）。
   用户名	否	< user-name>	连接身份验证的可选用户名。
   使用 TLS	否	True 或 False	使用传输安全层（TLS）保护连接。
   验证服务器证书	否	True 或 False	验证服务器的证书。
   服务器证书公用名	否	< 服务器证书通用名称 (server-cert-common-name)>	要使用的传输安全层 （TLS） 证书的名称。
   使用 IBM 请求标头格式	否	True 或 False	指示服务器预期采用 IBM 格式的 ELM 或 TRM 标头。

   例如：

   

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

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

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

   例如：

   选择 HIDX 文件和方法

   

   选择高级参数

   

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

测试工作流

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

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

   工作流完成运行后，将显示工作流运行历史记录。 成功的步骤显示复选标记，而不成功的步骤显示感叹号（！）。

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

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

相关内容

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