通过 Azure 逻辑应用中的标准工作流从 IBM 大型机分析并生成主机文件

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

若要从 Azure 逻辑应用中的标准工作流分析和生成新的 IBM 主机文件和 i 系列物理文件，可以使用基于服务提供商的内置 IBM 主机文件 连接器。 由于引入了大型机系统，开发人员使用无处不在的主机文件来存储任务关键型系统的丰富数据。 尽管此连接器不需要访问 IBM 大型机或中型系统，但必须使主机文件可用于标准工作流。 可以通过 FTP、Azure Blob 存储、主机集成服务器或合作伙伴软件设备提供该文件。 IBM 主机文件连接器在所有 Azure 逻辑应用区域中可用，但 Azure 政府和由世纪互联运营的 Microsoft Azure 除外。

本操作指南介绍了有关 IBM 主机文件连接器的以下方面：

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

查看连接器使用场景

在 IBM 大型机上，访问方法是操作系统中的特殊组件，负责进行文件处理。 在 20 世纪 70 年代，虚拟存储访问方法（VSAM）已构建，成为 IBM 大型机上最常用的访问方法。 VSAM 提供特定类型的文件，包括条目排序数据集、键序列数据集和相对记录数据集。

当前市场提供了多个直接连接到主机文件和运行数据作的解决方案。 许多解决方案要求你在大型机系统上安装软件。 尽管此选项适用于某些客户，但另一些客户希望避免在大型机系统中增加占用空间。

Microsoft Host Integration Server （HIS） 为主机文件提供托管适配器，不需要在大型机上安装软件。 但是，HIS 要求启用 IBM 分布式文件管理器（DFM） 大型机子系统，这需要逻辑单元（LU）协议 6.2。 此托管提供程序还要求配置 HIS 系统网络体系结构 （SNA） 网关，该网关提供对 DFM 的访问权限。

在大多数情况下，托管提供程序作为普通数据提供程序运行。 可以连接到主机文件系统、执行命令和检索数据。 尽管此选项非常适合某些客户， 但 IBM 主机文件 连接器要求将 IBM 主机文件以二进制格式提供给 Azure 逻辑应用中的标准工作流。 此要求可降低解决方案的复杂性，并使你能够使用你选择的工具来访问和管理主机文件中的数据。 使主机文件位于标准工作流可以使用触发器读取文件的位置后，IBM 主机文件连接器操作便可以分析该文件。

对于有兴趣在其大型机环境中（如 SQL Server 或 Azure Cosmos DB）中访问和使用数据库的客户， IBM 主机文件 连接器提供以 JSON 格式生成主机文件的功能。 此方法使你能够使用所选云数据库中的主机文件，并将数据作为主机文件发送回大型机或中型环境。

下图显示了 Azure 逻辑应用中 IBM 主机文件 连接器如何与其他系统交互，以读取、分析和生成主机文件内容：

为了扩展混合云方案，IBM 主机文件连接器适用于逻辑应用的 HIS 设计器，你可将它用于创建大型机主机文件的数据定义或数据映射。 对于此任务，HIS 设计器会将数据转换为 IBM 主机文件连接器用于在工作流中执行操作的元数据。 连接器执行数据类型转换，这些转换需要从前面的工作流作接收输入，并发送输出以供后续工作流作使用。 该连接器还提供表格数据定义和代码页转换。

通过 HIS 设计器生成元数据文件作为主机集成设计器 XML (HIDX) 文件后，可以将该文件作为映射项目添加到标准逻辑应用资源。 使用此方法，在添加 IBM 主机文件连接器操作时，工作流可以访问应用的元数据。 连接器从逻辑应用程序资源中读取元数据文件，并动态呈现二进制文件结构，以便在您的工作流中使用 IBM 主机文件 连接器进行操作。

连接器技术参考

本部分介绍 IBM 主机文件 连接器的可用作。 目前支持两个作： 分析主机文件内容 和 生成主机文件内容。

分析主机文件内容操作

下表汇总了 分析主机文件内容 作的参数：

生成主机文件内容操作

下表汇总了 “生成主机文件内容 ”作的参数：

先决条件

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

• 主机集成设计器 XML （HIDX） 文件，该文件为 IBM 主机文件 连接器提供识别主机文件数据结构所需的元数据。

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

  若要有效地分析和生成主机文件，工作流需要了解主机文件元数据。 但是，作为主机文件和数据库表之间的主要区别，主机文件没有描述数据结构的元数据。 若要创建此元数据，请使用用于逻辑应用的 HIS 设计器。 借助此工具，可以手动创建工作流使用的主机文件结构。 此外，还可以导入提供这些数据结构的 COBOL 定义 (copybook)。

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

• 要在其中分析或生成主机文件的标准逻辑应用工作流。

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

局限性

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

定义和生成元数据

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

上传 HIDX 文件

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

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

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

3. 继续下一部分，向工作流添加 IBM 主机文件。

本指南的后面部分，首次将 “分析主机文件内容” 作添加到工作流时，系统会提示你创建连接。 创建连接后，可以选择以前添加的 HIDX 文件、架构和要使用的参数。

添加解析主机文件内容的操作

按照以下步骤添加解析主机文件内容操作：

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

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

   这个示例继续使用Azure Blob 存储的基于服务提供商的内置触发器，名为“当 Blob 被添加或更新时”：

   

3. 若要从添加或更新的 Blob 中获取内容，请根据以下步骤添加名为读取 Blob 内容的Azure Blob 存储内置连接器操作。

4. 按照以下常规步骤添加名为“分析主机文件内容”的 IBM 主机文件内置连接器操作。

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

   参数	必选	价值	DESCRIPTION
   连接名称	是的	< connection-name>	连接的名称。
   代码页	否	<code-page>	用于转换文本的代码页码。
   从 iSeries	否	<mf-iseries>	指定文件是否源自 i Series 服务器。

   例如：

   

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

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

   参数	必选	价值	DESCRIPTION
   HIDX 名称	是的	<HIDX-file-name>	选择要使用的大型机主机文件 HIDX 文件。
   架构名称	是的	<schema-name>	在要使用的 HIDX 文件中选择架构。
   二进制内容	是的	<二进制内容>	选择从主机中提取的固定长度的二进制数据。

   例如，下图显示了 Visual Studio，其中包含一个示例主机文件（HIDX），其中包含 HIS Designer for Logic Apps 中的 CUSTOMER 表和 CUSTOMER_RECORD 架构：

   

   1. 使用 HIDX 文件中的值配置 HIDX 名称和架构名称：

      

   2. 对于“二进制内容”，请选择动态内容列表（闪电图标），然后选择“读取 blob 操作内容的响应”选项：

      

      完整的“分析主机文件内容”操作如以下示例所示：

      

   3. 现在，添加另一个操作来处理结果：

      此示例通过执行以下常规步骤，在文件传输协议（FTP）服务器上添加了创建文件的操作：

      

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

测试工作流

按照以下步骤确认工作流按预期运行：

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

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

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

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

添加“生成主机文件内容”操作

按照以下步骤添加“生成主机文件内容”动作：

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

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

   此示例继续使用“Azure Blob 存储”内置的基于服务提供商的触发器，名为“添加或更新 blob 时”：

   

3. 若要从添加的或更新的 Blob 获取内容，请按照这些常规步骤添加名为“读取 Blob 内容”的Azure Blob 存储内置连接器操作。

4. 按照以下常规步骤添加名为“生成主机文件内容”的 IBM 主机文件内置连接器操作。

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

   参数	必选	价值	DESCRIPTION
   连接名称	是的	< connection-name>	连接的名称。
   代码页	否	<code-page>	用于转换文本的代码页码。
   从 iSeries	否	<mf-iseries>	指定文件是否源自 i Series 服务器。

   例如：

   

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

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

   参数	必选	价值	DESCRIPTION
   HIDX 名称	是的	<HIDX-file-name>	提供要使用的大型机主机文件 HIDX 文件的名称。
   架构名称	是的	<schema-name>	提供要使用的 HIDX 文件中架构的名称。
   行	是的	<行>	提供要转换为 IBM 格式的记录数组。 若要从前面的工作流作中选择输出，请执行以下步骤： 1.在“行”框内选择，然后选择动态内容选项（竖直闪电）。 2. 从动态内容列表中，选择前一个操作的输出结果。 例如，从“读取 blob 内容”部分，选择“来自读取 blob 操作内容的响应”。 提示：若要以 JSON 格式输入整个数据对象，请选择 “切换到输入整个数组 ”选项。

   例如，下图显示了 Visual Studio，并在逻辑应用的 HIS 设计器中展示了一个示例 HIDX 文件：

   

   1. 使用 HIDX 文件中的值配置 HIDX 名称和架构名称：

      

   2. 对于“行”>“行项 - 1”字段，请选择动态内容列表（闪电图标），然后选择“读取 blob 操作内容的响应”选项：

      

      完整的生成主机文件内容动作如下示例所示：

      

   3. 现在，添加另一个操作来处理结果。

      此示例通过执行以下常规步骤，在文件传输协议（FTP）服务器上添加创建文件的操作：

      

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

测试工作流

按照以下步骤确认工作流按预期运行：

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

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

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

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

相关内容

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