Интеграция программ COBOL и РОГО в системах среднего уровня 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 в рабочий процесс приложения логики "Стандартный"
Зачем использовать этот соединитель?
Более 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. На протяжении многих лет клиенты использовали IN TRANSACTION Integrator (TI) для интеграции систем IBM i и Windows в локальной среде. Соединитель IBM i Program Call использует модель программирования TCP/IP для взаимодействия с программами IBM i COBOL и РОГО.
На следующей схеме показано, как соединитель IBM i взаимодействует с системой IBM i:
Чтобы расширить эти гибридные облачные сценарии, соединитель IBM i в стандартном рабочем процессе работает с ЕГО конструктором для Logic Apps, который можно использовать для создания определения программы или карты программы COBOL или РОЛЕВОЙ программы. Для этой задачи конструктор HIS использует модель программирования, которая определяет характеристики обмена данными между серединой и рабочим процессом. Конструктор HIS преобразует эти сведения в метаданные, которые соединитель IBM i использует при выполнении действия в рабочем процессе.
После создания файла метаданных в качестве XML-файла конструктора интеграции узлов (HIDX) из КОНСТРУКТОРА ЕГО можно добавить этот файл в качестве артефакта карты в ресурс приложения логики "Стандартный". Таким образом, рабочий процесс может получить доступ к метаданным приложения при добавлении действия соединителя IBM i. Соединитель считывает файл метаданных из ресурса приложения логики и динамически предоставляет параметры для использования с соединителем IBM i в рабочем процессе. Затем можно указать параметры для ведущего приложения, а соединитель возвращает результаты рабочему процессу. В результате вы можете интегрировать устаревшие приложения с Azure, Корпорацией Майкрософт, другими приложениями, службами и системами, поддерживаемыми Azure Logic Apps.
технический справочник по Подключение or
В следующем разделе описаны операции для соединителя IBM i, который в настоящее время включает только следующее действие:
Вызов программы IBM i
| Параметр | Обязательное поле | Type | Описание |
|---|---|---|---|
| Имя HIDX | Да | Строка | Выберите ФАЙЛ IBM i HIDX, который вы хотите использовать. |
| Имя метода | Да | Строка | Выберите метод, который следует использовать. |
| Дополнительные параметры | No | Различается | Этот список отображается после выбора метода, чтобы можно было добавить другие параметры для использования с выбранным методом. Доступные параметры зависят от выбранного файла HIDX и выбранного метода. |
Эта операция также включает дополнительные параметры, которые отображаются после выбора метода, для выбора и использования с выбранным методом. Эти параметры зависят от файла HIDX и выбранного метода.
Ограничения
В настоящее время этот соединитель требует передачи HIDX-файла непосредственно в ресурс приложения логики уровня "Стандартный", а не учетную запись интеграции.
Необходимые компоненты
Учетная запись и подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.
Доступ к середине, на котором размещена система IBM i
XML-файл КОНСТРУКТОРа интеграции узлов (HIDX), предоставляющий необходимые метаданные для соединителя IBM i Program Call для выполнения программы среднего уровня.
Чтобы создать этот HIDX-файл, скачайте и установите ЕГО конструктор для Azure Logic Apps. Единственным необходимым условием является наличие Microsoft .NET Framework 4.8.
Чтобы вызвать программу среднего порядка, рабочий процесс должен понять тип, параметры и возвращаемые значения программы среднего порядка. Соединитель IBM i управляет этим процессом и преобразованиями данных, которые необходимы для предоставления входных данных из рабочего процесса в программу среднего порядка и отправки выходных данных, созданных из программы среднего порядка в рабочий процесс. Соединитель также предоставляет табличное определение данных и перевод кодовой страницы. Для этого процесса Azure Logic Apps требует предоставления этих сведений в виде метаданных.
Чтобы создать эти метаданные, используйте конструктор HIS для Logic Apps. С помощью этого средства можно вручную создать методы, параметры и возвращать значения, используемые в рабочем процессе. Вы также можете импортировать определения программ COBOL или РОЛГОВ (книги копирования), которые предоставляют эти сведения.
Средство создает XML-файл КОНСТРУКТОРа интеграции узлов (HIDX), предоставляющий необходимые метаданные для соединителя. Если вы используете ЕГО, с помощью конструктора TI можно создать HIDX-файл.
Рабочий процесс приложения логики уровня "Стандартный", в котором требуется интегрироваться с системой IBM i
Соединитель IBM i не имеет триггеров, поэтому используйте любой триггер для запуска рабочего процесса, например триггер повторения или триггер запроса . Затем можно добавить действие соединителя IBM i. Чтобы приступить к работе, создайте пустой рабочий процесс в ресурсе приложения логики "Стандартный".
Определение и создание метаданных
После скачивания и установки ЕГО конструктора для Azure Logic Apps выполните следующие действия, чтобы создать ФАЙЛ HIDX из артефакта метаданных.
Отправка HIDX-файла
Чтобы рабочий процесс использовал HIDX-файл, выполните следующие действия.
Перейдите в папку, в которой сохранен файл HIDX, и скопируйте файл.
В портал Azure отправьте HIDX-файл в виде сопоставления с ресурсом приложения логики "Стандартный".
Далее в этом руководстве при первом добавлении действия соединителя IBM i Program Call в рабочий процесс вам будет предложено создать подключение между рабочим процессом и системой среднего порядка. После создания подключения можно выбрать добавленный ранее HIDX-файл, метод запуска и параметры.
Добавление действия IBM i
В портал Azure откройте ресурс приложения логики "Стандартный" и рабочий процесс в конструкторе.
Если вы еще не добавили триггер для запуска рабочего процесса, выполните следующие общие действия, чтобы добавить нужный триггер.
Этот пример продолжается с триггером запроса с именем "При получении HTTP-запроса".
Чтобы добавить действие соединителя IBM i, выполните следующие общие действия, чтобы добавить встроенное действие соединителя IBM i Program Call с именем Call a IBM i Program.
После появления области сведений о подключении укажите следующие сведения, такие как имя сервера узла и сведения о конфигурации системы IBM i:
Параметр Обязательное поле значение Описание Имя подключения Да <имя_соединения> Имя подключения. Общее имя сертификата сервера No <имя server-cert-common-name> Имя сертификата уровня безопасности транспорта (TLS) для использования Кодовая страница No <кодовая страница> Номер кодовой страницы, используемый для преобразования текста Пароль No <пароль> Необязательный пароль пользователя для проверки подлинности подключения Номер порта Да <номер порта> Номер порта, используемый для проверки подлинности подключения Имя сервера Да <server-name> Имя сервера Время ожидания No <timeout> Период времени ожидания в секундах при ожидании ответов с сервера Имя пользователя No <имя-пользователя> Необязательное имя пользователя для проверки подлинности подключения Использование TLS No Значение true или false Защита подключения с помощью уровня безопасности транспорта (TLS). Проверка сертификата сервера No Значение true или false Проверьте сертификат сервера. Например:
По завершении нажмите кнопку "Создать".
После появления области сведений о действии в разделе "Параметры " укажите необходимые сведения:
Параметр Обязательное поле значение Описание Имя HIDX Да <HIDX-file-name> Выберите ФАЙЛ IBM i HIDX, который вы хотите использовать. Имя метода Да <method-name> Выберите метод, который следует использовать. Дополнительные параметры No Различается Этот список отображается после выбора метода, чтобы можно было добавить другие параметры для использования с выбранным методом. Доступные параметры зависят от выбранного файла HIDX и выбранного метода. Например:
Выбор файла и метода HIDX
Выбор дополнительных параметров
Закончив работу, сохраните свой рабочий процесс. На панели инструментов конструктора нажмите кнопку "Сохранить".
Тестирование рабочего процесса
Чтобы запустить рабочий процесс, в меню рабочего процесса выберите "Обзор". На панели инструментов "Обзор" нажмите кнопку "Выполнить".>
После завершения выполнения рабочего процесса появится журнал выполнения рабочего процесса. Успешные шаги показывают проверка метки, в то время как неудачные шаги показывают восклицательный знак (!).
Чтобы проверить входные и выходные данные для определенного шага, разверните его.
Чтобы просмотреть выходные данные, выберите Показать необработанные выходные данные.
Следующие шаги
- Мониторинг состояния выполнения рабочего процесса, проверка и журнал выполнения рабочего процесса и настройка оповещений в Azure Logic Apps
- Просмотр метрик для работоспособности и производительности рабочих процессов в Azure Logic Apps
- Мониторинг и сбор диагностических данных для рабочих процессов в Azure Logic Apps
- Включение и просмотр расширенной телеметрии в приложении Аналитика для рабочих процессов уровня "Стандартный" в Azure Logic Apps