Интеграция программ COBOL и RPG в средних системах IBM со стандартными рабочими процессами в Azure Logic Apps

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

Чтобы получить доступ и запускать программы COBOL и RPG на системах IBM midrange из стандартных рабочих процессов в Azure Logic Apps, вы можете использовать встроенный соединитель на основе провайдера услуг IBM i Program Call. Операционная система IBM i предоставляет сервер распределенных программных вызовов (DPC). Соединитель взаимодействует с сервером IBM i DPC для выполнения программ COBOL и RPG с помощью TCP/IP. Соединитель IBM i доступен во всех регионах Azure Logic Apps, за исключением Azure для государственных организаций и Microsoft Azure, управляемых 21Vianet.

В этой статье описываются следующие аспекты соединителя IBM i:

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

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

Более 50 лет назад IBM выпустила первые системы среднего порядка. IBM рекламировала их как "Малый размер, малый в цене и Большой в производительности. Это система на данный момент и для будущего". На протяжении многих лет системы среднего порядка развивались и стали широко распространенными в средних компаниях или крупных предприятиях для расширения сред мейнфрейма. Системы midrange, использующие IBM i, как правило, Power Systems, поддерживают TCP/IP и SNA.

Система IBM i включает функцию сервера DPC, которая позволяет большинству приложений IBM i взаимодействовать с клиентами, такими как Azure Logic Apps, с помощью шаблона, инициируемого клиентом, только для ответа на запросы с минимальными изменениями. DPC — это документированные протоколы, поддерживающие интеграцию между программами в системе IBM i, к которой клиентские приложения могут легко получить доступ с помощью сетевого протокола TCP/IP.

Сервер интеграции узлов Майкрософт (HIS) обеспечивает подключение к системам IBM i с помощью TCP/IP и APPC LU6.2. Многие годы клиенты использовали HIS Transaction Integrator для интеграции локальных систем IBM i и Windows. Соединитель IBM i Program Call использует модель программирования TCP/IP для взаимодействия с программами IBM i COBOL и RPG.

На следующей схеме показано, как соединитель IBM i взаимодействует с системой IBM i:

Чтобы расширить эти гибридные облачные сценарии, соединитель IBM i в стандартном рабочем процессе работает с HIS Designer для Logic Apps, который можно использовать для создания определения программы или карты программы программы COBOL или RPG. Для этой задачи конструктор HIS использует модель программирования , которая определяет характеристики обмена данными между серединой и рабочим процессом. Конструктор HIS преобразует эти сведения в метаданные, которые соединитель IBM i использует при выполнении действия в рабочем процессе.

После создания файла метаданных в виде XML-файла конструктора интеграции хостов (HIDX) из HIS Designer, можно добавить этот файл в качестве артефакта карты в ресурс стандартного логического приложения. Таким образом, рабочий процесс сможет получить доступ к метаданным вашего приложения при добавлении действия соединителя IBM i. Соединитель считывает файл метаданных из ресурса приложения логики и динамически предоставляет параметры для использования с соединителем IBM i в рабочем процессе. Затем можно указать параметры для ведущего приложения, а соединитель возвращает результаты рабочему процессу. В результате вы можете интегрировать устаревшие приложения с Azure, Корпорацией Майкрософт, другими приложениями, службами и системами, поддерживаемыми Azure Logic Apps.

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

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

Эта операция также включает дополнительные параметры, которые отображаются после выбора метода, для выбора и использования с выбранным методом. Эти параметры зависят от файла HIDX и выбранного метода.

Предпосылки

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

• Доступ к серверу среднего порядка, на котором размещена система IBM i.

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

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

  Чтобы вызвать программу среднего порядка, рабочий процесс должен понять тип, параметры и возвращаемые значения программы среднего порядка. Соединитель IBM i управляет этим процессом и преобразованиями данных. Эти необходимые преобразования предоставляют входные данные из рабочего процесса в программу среднего порядка и отправляют все выходные данные, созданные из программы среднего порядка в рабочий процесс. Соединитель также предоставляет табличное определение данных и перевод кодовой страницы. Для этого процесса Azure Logic Apps требует предоставления этих сведений в виде метаданных.

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

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

• Рабочий процесс логического приложения "Standard", в котором требуется интегрироваться с системой IBM i.

  Соединитель IBM i не имеет триггеров, поэтому используйте любой триггер для запуска рабочего процесса, например триггер повторения или триггер запроса . Затем можно добавить действие соединителя IBM i. Чтобы приступить к работе, создайте пустой поток работ в ресурсе стандартного логического приложения.

Ограничения

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

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

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

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

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

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

2. На портале Azure откройте ресурс стандартного логического приложения.

3. В меню приложения логики в разделе Artifactsзагрузите HIDX-файл как карту к ресурсу приложения логики.

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

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

Добавьте действие IBM i

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

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

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

   Этот пример продолжается с триггером запроса с именем При получении HTTP-запроса:

   

3. Чтобы добавить действие соединителя IBM i, выполните следующие общие действия, чтобы добавить встроенное действие соединителя IBM i Program Call с именем Call a IBM i Program.

4. После появления области сведений о подключении укажите следующие сведения, такие как имя сервера узла и сведения о конфигурации системы IBM i:

   Параметр	Обязательно	Ценность	Описание
   Имя подключения	Да	< имя_соединения>	Имя для вашего подключения.
   Общее имя сертификата сервера	нет	< server-cert-common-name>	Имя используемого сертификата уровня безопасности транспорта (TLS).
   Кодовая страница	нет	< кодовая страница>	Номер кодовой страницы, используемый для преобразования текста.
   Пароль	нет	< пароль>	Необязательный пароль пользователя для проверки подлинности подключения.
   Номер порта	Да	< номер порта>	Номер порта, используемый для проверки подлинности подключения.
   Имя сервера	Да	< имя сервера>	Имя сервера.
   Время ожидания	нет	< Времени ожидания>	Период времени ожидания в секундах при ожидании ответов с сервера.
   Имя пользователя	нет	< user-name>	Необязательное имя пользователя для проверки подлинности подключения.
   Использование TLS	нет	Истина или ложь	Обеспечьте безопасность подключения с помощью уровня защиты транспорта (TLS).
   Проверка сертификата сервера	нет	Истина или ложь	Проверьте сертификат сервера.

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

   

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

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

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

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

   Выбор файла и метода HIDX

   

   Выбор дополнительных параметров

   

7. Закончив работу, сохраните свой рабочий процесс. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

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

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

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