Анализ и создание файлов хостов из мейнфреймов IBM для стандартных рабочих процессов в Azure Logic Apps

Область применения: Azure Logic Apps (стандартная версия)

Чтобы проанализировать и создать новые файлы узлов IBM и физические файлы серии i из стандартных рабочих процессов в Azure Logic Apps, можно использовать встроенный соединитель поставщика услуг. С момента внедрения систем мейнфрейма разработчики использовали вездесущие файлы узлов для хранения богатых данных для критически важных систем. Хотя этот коннектор не требует доступа к системе IBM мейнфрейм или среднего уровня, необходимо предоставить файл узла для стандартного рабочего процесса. Файл можно сделать доступным через FTP, хранилище BLOB-объектов Azure, сервер интеграции узла или программное устройство партнера. Соединитель файлов узла IBM доступен во всех регионах Azure Logic Apps, за исключением Azure для государственных организаций и Microsoft Azure, управляемых 21Vianet.

В этом руководстве описаны следующие аспекты коннектора IBM Host File:

• Сценарии использования коннектора файлов узла IBM в Azure Logic Apps
• Предварительные требования и настройка для использования коннектора IBM Host File
• Шаги для добавления действий соединителя файлов узла IBM в рабочий процесс стандартного логического приложения

Просмотр сценариев использования соединителя

В мейнфреймах IBM методы доступа, которые являются специальными компонентами в операционной системе, обрабатывают обработку файлов. В 1970-х годах был создан метод доступа к виртуальному хранилищу (VSAM) и стал самым широко используемым методом доступа в мейнфреймах IBM. VSAM предоставляет определенные типы файлов, включая последовательно расположенные наборы данных, наборы данных, отсортированные по ключам, и наборы данных с относительной последовательностью записей.

Текущий рынок предлагает несколько решений, которые напрямую подключаются к файлам узлов и выполняют операции с данными. Многие решения требуют установки программного обеспечения в системе мейнфрейма. Хотя этот вариант хорошо подходит для некоторых клиентов, другие хотят избежать роста присутствия в своих системах мейнфреймов.

Сервер интеграции узлов Майкрософт (HIS) предоставляет управляемый адаптер для файлов узлов и не требует установки программного обеспечения на мейнфрейме. Тем не менее, HIS требует включения подсистемы мейнфреймов IBM Distributed File Manager (DFM), для которой требуется протокол Logical Unit (LU) 6.2. Этот управляемый поставщик также требует настройки шлюза архитектуры сетей системы HIS (SNA), который предоставляет доступ к DFM.

В большинстве случаев управляемый поставщик работает как обычный поставщик данных. Вы можете подключиться к файловой системе узла, выполнить команды и получить данные. Хотя этот вариант является отличной альтернативой для некоторых клиентов, соединитель IBM Host File требует, чтобы файлы узлов IBM были доступны в двоичном формате в Стандартных рабочих процессах платформы Azure Logic Apps. Это требование снижает сложность решения и позволяет использовать выбранные средства для доступа к данным в файлах узлов и управления ими. После того как файл узла доступен в месте, где рабочий процесс Standard может использовать триггер для чтения файла, операция соединителя файлов узла IBM может проанализировать файл.

Для клиентов, заинтересованных в доступе и использовании баз данных в средах основных и специализированных систем, таких как SQL Server или Azure Cosmos DB, коннектор IBM Host File предоставляет возможность создавать файлы в формате JSON. Этот подход позволяет использовать файлы узлов в облачной базе данных и отправлять данные обратно в качестве файла узла в мейнфрейм или среды среднего порядка.

На следующей схеме показано, как соединитель IBM Host File в Azure Logic Apps взаимодействует с другими системами для чтения, разбора и генерации содержимого файла узла.

Чтобы расширить гибридные облачные сценарии, соединитель IBM Host File работает с конструктором HIS для Logic Apps, который можно использовать для создания определения данных или карты данных файла хоста мейнфрейма. Для этой задачи КОНСТРУКТОР ЕГО преобразует данные в метаданные, которые соединитель файлов узла IBM использует для выполнения действий в рабочем процессе. Соединитель выполняет преобразования типов данных, которые необходимы для получения входных данных из предыдущих операций рабочего процесса и отправки выходных данных для использования последующими действиями рабочего процесса. Соединитель также предоставляет табличное определение данных и перевод кодовой страницы.

После создания файла метаданных в виде XML-файла конструктора интеграции хостов (HIDX) из HIS Designer, можно добавить этот файл в качестве артефакта карты в ресурс стандартного логического приложения. С помощью этого подхода рабочий процесс может получить доступ к метаданным вашего приложения при добавлении действия соединителя IBM Host File. Соединитель считывает файл метаданных из ресурса приложения логики и динамически представляет структуру двоичного файла для использования с действиями соединителя узла IBM в рабочем процессе.

Технический справочник по соединителю

В этом разделе описываются доступные операции для соединителя файлов узла IBM . В настоящее время поддерживаются два действия: анализ содержимого файла узла и создание содержимого файла узла.

Действие анализа содержимого файла узла

В следующей таблице перечислены параметры действия "Анализ содержимого файла узла ".

Создание действия "Содержимое файла узла"

В следующей таблице перечислены параметры действия "Создать содержимое файла узла ".

Предпосылки

• Учетная запись и подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.

• XML-файл Host Integration Designer (HIDX), предоставляющий необходимые метаданные для коннектора файлов IBM Host для идентификации структуры данных файла хоста.

  Чтобы создать этот HIDX-файл, скачайте и установите HIS Designer для Azure Logic Apps. Единственным предварительным условием является Microsoft .NET Framework 4.8.

  Для эффективного анализа и создания файлов узлов рабочий процесс должен понять метаданные файла узла. Однако в качестве ключевого различия между файлом узла и таблицей базы данных файл узла не содержит метаданных, описывающих структуру данных. Чтобы создать эти метаданные, используйте конструктор HIS для Logic Apps. С помощью этого средства можно вручную создать структуру файлов узла, которую использует рабочий процесс. Вы также можете импортировать описания COBOL (копибуки), которые предоставляют эти структуры данных.

  Средство создает XML-файл Host Integration Designer (HIDX), который предоставляет необходимые метаданные для соединителя, чтобы распознать структуру данных файла хоста. Если вы используете HIS, вы можете использовать дизайнер интегратора транзакций HIS (TI), чтобы создать файл HIDX.

• Рабочий процесс логического приложения стандартного уровня, в котором требуется проанализировать или создать файл hosts.

  Коннектор IBM Host File не имеет триггеров, поэтому используйте любой триггер для запуска рабочего процесса, например, триггер Повторение или триггер Хранилище Blob-объектов Azure. Затем можно добавить действия для соединителя файлов узла IBM. Чтобы приступить к работе, создайте пустой поток работ в ресурсе стандартного логического приложения.

Ограничения

В настоящее время этот соединитель требует загрузки вашего HIDX-файла непосредственно в ресурс логического приложения Стандартного уровня, а не в учетную запись интеграции.

Определение и создание метаданных

После загрузки и установки HIS Designer для Azure Logic Apps выполните следующие действия, чтобы создать файл HIDX из артефакта метаданных.

Отправка HIDX-файла

Чтобы рабочий процесс использовал HIDX-файл, выполните следующие действия.

1. Перейдите в папку, в которой сохранен файл HIDX, и скопируйте файл.

2. На портале Azureзагрузите HIDX-файл как карту в ресурс логического приложения уровня "Стандартный".

3. Перейдите к следующей секции, чтобы добавить действие узлового файла IBM в рабочий процесс.

Далее в этом руководстве при добавлении действия "Анализ содержимого файла узла " в рабочий процесс в первый раз появится запрос на создание подключения. После создания подключения можно выбрать ранее добавленный HIDX-файл, схему и используемые параметры.

Добавление действия анализа содержимого файла узла

Выполните следующие действия, чтобы добавить действие анализа содержимого файла узла:

1. На портале Azure откройте в конструкторе ресурс и рабочий процесс вашего стандартного приложения логики.

2. Если у вас нет триггера для запуска рабочего процесса, выполните следующие общие действия, чтобы добавить нужный триггер.

   Этот пример продолжается со встроенным триггером на основе поставщика услуг хранилища BLOB-объектов Azure с именем "При добавлении или обновлении BLOB-объекта":

   

3. Чтобы получить содержимое из добавленного или обновленного BLOB-объекта, добавьте встроенное действие соединителя Azure Blob Storage с именем Чтение содержимого BLOB, выполняя следующие общие шаги.

4. Добавьте встроенное действие соединителя IBM Host File с именем Parse Host File Contents , выполнив следующие общие действия.

5. После появления области сведений о подключении укажите следующие сведения:

   Параметр	Обязательно	Ценность	Описание
   Имя подключения	Да	< имя_соединения>	Имя для вашего подключения.
   Кодовая страница	нет	< кодовая страница>	Номер кодовой страницы, используемый для преобразования текста.
   Из iSeries	нет	< MF-iseries>	Укажите, происходит ли файл с сервера серии i.

   Рассмотрим пример.

   

6. По завершении нажмите кнопку "Создать".

7. После появления области сведений о действии в разделе "Параметры " укажите необходимые сведения:

   Параметр	Обязательно	Ценность	Описание
   Имя HIDX	Да	< HIDX-file-name>	Выберите файл HIDX узла мейнфрейма, который вы хотите использовать.
   Имя схемы	Да	< имя схемы>	Выберите схему в файле HIDX, который вы хотите использовать.
   Двоичное содержимое	Да	< двоичное содержимое>	Извлеките из хоста двоичные данные с записью фиксированной длины.

   Например, на следующем рисунке показан Visual Studio с примером файла узла (HIDX), содержащего таблицу CUSTOMER и схему CUSTOMER_RECORD в конструкторе HIS для Logic Apps:

   

   1. Настройте имя HIDX и имя схемы со значениями из HIDX-файла:

      

   2. Для двоичного содержимого выберите список динамического содержимого (значок молнии) и выберите ответ из параметра "Содержимое действия большого двоичного объекта ":

      

      Полное действие анализа содержимого файла узла выглядит следующим образом:

      

   3. Теперь добавьте еще одно действие для обработки результата:

      В этом примере добавляется действие для создания файла на сервере ПРОТОКОЛА ПЕРЕДАЧи файлов (FTP), выполнив следующие общие действия.

      

8. По завершении сохраните рабочий процесс. На панели инструментов конструктора выберите Сохранить.

Тестирование рабочего процесса

Выполните следующие действия, чтобы убедиться, что рабочий процесс выполняется должным образом:

1. Чтобы запустить рабочий процесс, на панели инструментов конструктора нажмите кнопку "Выполнить>".

   После завершения выполнения рабочего процесса появится журнал выполнения рабочего процесса. Успешные шаги показывают флажки, в то время как неудачные шаги показывают восклицательный знак (!).

2. Чтобы просмотреть входные и выходные данные для каждого шага, разверните этот шаг.

3. Чтобы просмотреть выходные данные, выберите "Просмотреть необработанные выходные данные".

Добавление действия "Генерация содержимого файла хоста"

Чтобы добавить действие "Создать содержимое файла узла", выполните следующие действия:

1. На портале Azure откройте в конструкторе ресурс и рабочий процесс вашего стандартного приложения логики.

2. Если у вас нет триггера для запуска рабочего процесса, выполните следующие общие действия, чтобы добавить нужный триггер.

   Этот пример продолжается со встроенным триггером службы на основе поставщика услуг хранилища BLOB-объектов Azure с именем "Когда BLOB добавляется или обновляется:

   

3. Чтобы получить содержимое из добавленного или обновленного большого двоичного объекта, добавьте встроенное действие соединителя хранилища BLOB-объектов Azure с именем Чтение содержимого BLOB, выполнив следующие общие действия.

4. Добавьте встроенное действие коннектора файла узла IBM, именуемое Создание содержимого файла узла, выполнив следующие общие шаги.

5. После появления области сведений о подключении укажите следующие сведения:

   Параметр	Обязательно	Ценность	Описание
   Имя подключения	Да	< имя_соединения>	Имя подключения.
   Кодовая страница	нет	< кодовая страница>	Номер кодовой страницы, используемый для преобразования текста.
   Из iSeries	нет	< MF-iseries>	Укажите, происходит ли файл с сервера серии i.

   Рассмотрим пример.

   

6. По завершении нажмите кнопку "Создать".

7. После появления области сведений о действии в разделе "Параметры " укажите необходимые сведения:

   Параметр	Обязательно	Ценность	Описание
   Имя HIDX	Да	< HIDX-file-name>	Укажите имя файла HIDX узла мейнфрейма, который вы хотите использовать.
   Имя схемы	Да	< имя схемы>	Укажите имя схемы в файле HIDX, который вы хотите использовать.
   Строки	Да	< строки>	Предоставьте массив записей для преобразования в формат IBM. Чтобы выбрать выходные данные из предыдущей операции рабочего процесса, выполните следующие действия. 1. Выберите внутри поля "Строки", а затем выберите вариант динамического содержимого (значок молнии). 2. В списке динамического содержимого выберите выходные данные из предыдущего действия. Например, в разделе Чтение содержимого двоичных объектов выберите Ответ от действия чтения содержимого двоичного объекта. Совет. Чтобы ввести весь объект данных в формате JSON, выберите параметр "Переключиться на ввод всего массива ".

   Например, на следующем рисунке показан Visual Studio с примером HIDX-файла в конструкторе HIS для Logic Apps:

   

   1. Настройте имя HIDX и имя схемы со значениями из HIDX-файла:

      

   2. В поле "Строки>Строки - 1 выберите список динамического содержимого (значок молнии) и выберите параметр ответ из действия "Чтение содержимого BLOB-объекта":

      

      Полное действие создания содержимого файла узла выглядит следующим образом:

      

   3. Теперь добавьте еще одно действие для обработки результата.

      В этом примере добавляется действие для создания файла на сервере ПРОТОКОЛА ПЕРЕДАЧи файлов (FTP), выполнив следующие общие действия.

      

8. По завершении сохраните рабочий процесс. На панели инструментов конструктора выберите Сохранить.

Тестирование рабочего процесса

Выполните следующие действия, чтобы убедиться, что рабочий процесс выполняется должным образом:

1. Чтобы запустить рабочий процесс, на панели инструментов конструктора нажмите кнопку "Выполнить>".

   После завершения выполнения рабочего процесса появится журнал выполнения рабочего процесса. Успешные шаги показывают флажки, в то время как неудачные шаги показывают восклицательный знак (!).

2. Чтобы просмотреть входные и выходные данные для каждого шага, разверните этот шаг.

3. Чтобы просмотреть выходные данные, выберите "Просмотреть необработанные выходные данные".

Связанный контент

• Проверка состояния рабочего процесса, просмотр журнала выполнения и настройка оповещений в Azure Logic Apps
• Просмотр метрик для работоспособности и производительности рабочих процессов в Azure Logic Apps
• Мониторинг и сбор диагностических данных для рабочих процессов в Azure Logic Apps
• Включение и просмотр расширенной телеметрии в Application Insights для стандартных рабочих процессов в Azure Logic Apps