你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
将 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 事务集成器（TI）将 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 程序
| 参数 | 必选 | Type | 描述 |
|---|---|---|---|
| HIDX 名称 | 是 | 字符串 | 选择要使用的 CICS HIDX 文件。 |
| “方法名称” | 是 | 字符串 | 在要使用的 HIDX 文件中选择该方法。 |
| 高级参数 | 否 | 多种多样 | 选择方法后会显示此列表，以便添加其他参数以用于所选方法。 可用参数因 HIDX 文件和所选方法而异。 |
此操作还包括在选择方法后显示的高级参数，供你选择和使用所选方法。 这些参数因 HIDX 文件和所选方法而异。
限制
目前，此连接器要求将 HIDX 文件直接上传到标准逻辑应用资源，而不是集成帐户。
先决条件
Azure 帐户和订阅。 如果没有 Azure 订阅，请注册一个免费 Azure 帐户。
访问托管 CICS 系统的大型机
主机集成设计器 XML （HIDX） 文件，该文件为 CICS 程序调用连接器提供执行大型机程序所需的元数据。
若要创建此 HIDX 文件，请下载并安装 HIS Designer for Azure 逻辑应用。 唯一的必备组件是 Microsoft .NET Framework 4.8。
若要调用大型机程序，工作流需要了解大型机程序的类型、参数和返回值。 CICS 连接器管理此过程和数据转换，这是将工作流中的输入数据提供给大型机程序以及将从大型机程序生成的任何输出数据发送到工作流所必需的。 连接器还提供表格数据定义和代码页转换。 对于此过程，Azure 逻辑应用要求将此信息作为元数据提供。
若要创建此元数据，请使用 用于逻辑应用的 HIS 设计器。 借助此工具，可以手动创建在工作流中使用的方法、参数和返回值。 还可以导入提供此信息的 COBOL 或 RPG 程序定义（copybook）。
该工具生成主机集成设计器 XML （HIDX） 文件，该文件为连接器提供必要的元数据。 如果使用 HIS，可以使用 TI 设计器创建 HIDX 文件。
要与 CICS 系统集成的标准逻辑应用工作流
CICS 连接器没有触发器，因此请使用任何触发器启动工作流，例如 重复 触发器或 请求 触发器。 然后，可以添加 CICS 连接器操作。 若要开始，请在标准逻辑应用资源中创建一个空白工作流。
定义和生成元数据
下载并安装 HIS Designer for Azure 逻辑应用后，请按照以下步骤从元数据项目生成 HIDX 文件。
上传 HIDX 文件
若要使工作流使用 HIDX 文件，请执行以下步骤：
转到保存 HIDX 文件的文件夹，并复制该文件。
现在， 向工作流添加 CICS 操作。
在本指南的后面部分，首次将 CICS 计划呼叫连接器操作添加到工作流时，系统会提示你在工作流和大型机系统之间创建连接。 创建连接后，可以选择以前添加的 HIDX 文件、要运行的方法以及要使用的参数。
添加 CICS 操作
在 Azure 门户的设计器中，打开标准逻辑应用资源和工作流。
如果尚未添加用于启动工作流的触发器， 请按照以下常规步骤添加所需的触发器。
此示例继续使用名为“收到 HTTP 请求时”的请求触发器。
若要添加 CICS 连接器操作，请按照以下常规步骤添加名为“调用 CICS 计划”的 CICS 计划调用内置连接器操作。
显示连接详细信息窗格后，提供以下信息，例如主机服务器名称和 CICS 系统配置信息：
参数 必须 值 说明 连接名称 是 <connection-name> 连接名称 编程模型 是 <CICS-programming-model> 选定的 CICS 编程模型。 有关详细信息，请参阅 “编程模型 ”和 “选择适当的编程模型”。 代码页 否 <code-page> 用于转换文本的代码页码 密码 否 <password> 用于连接身份验证的可选用户密码 端口号 是 <port-number> 用于连接身份验证的端口号 服务器名称 是 <server-name> 服务器名称 超时 否 <超时> 等待来自服务器的响应时超时期限（以秒为单位） 用户名 否 <user-Name> 连接身份验证的可选用户名 使用 TLS 否 判断对错 使用传输安全层（TLS）保护连接。 验证服务器证书 否 判断对错 验证服务器的证书。 服务器证书公用名 否 <server-cert-common-name> 要使用的传输安全层 （TLS） 证书的名称 使用 IBM 请求标头格式 否 判断对错 服务器需要 IBM 格式的 ELM 或 TRM 标头 例如：
完成后，选择“ 新建”。
操作详细信息窗格出现后，在“ 参数 ”部分中提供所需的信息：
参数 必须 值 说明 HIDX 名称 是 <HIDX-file-name> 选择要使用的 CICS HIDX 文件。 “方法名称” 是 <method-name> 在要使用的 HIDX 文件中选择该方法。 高级参数 否 多种多样 选择方法后会显示此列表，以便添加其他参数以用于所选方法。 可用参数因 HIDX 文件和所选方法而异。 例如：
选择 HIDX 文件和方法
选择高级参数
完成后，保存工作流。 在设计器工具栏上，选择“ 保存”。
测试工作流
若要运行工作流，请在工作流菜单上选择“ 概述”。 在“概述”工具栏上，选择“运行”>“运行”。
工作流完成运行后，将显示工作流的运行历史记录。 成功的步骤显示检查标记，而不成功的步骤显示感叹号（！）。
若要查看每个步骤的输入和输出，请展开该步骤。
若要查看输出，请选择“查看原始输出”。