Интегрировать программы CICS на мейнфреймах IBM со стандартными рабочими процессами в Azure Logic Apps

Статья
2025-04-08

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

Для доступа и запуска приложений мейнфреймов IBM в системах управления информацией о клиентах (CICS) из стандартных рабочих процессов в Azure Logic Apps можно использовать встроенный соединитель CICS Program Call, основанный на поставщике услуг. CICS предоставляет монитор программы транзакций (TP) с интегрированным диспетчером транзакций (TM). Соединитель взаимодействует с программами транзакций IBM CICS с помощью TCP/IP. Соединитель CICS доступен во всех регионах Azure Logic Apps, за исключением Azure для государственных организаций и Microsoft Azure, управляемых 21Vianet.

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

Сценарии использования соединителя CICS в Azure Logic Apps
Предварительные требования и настройка для использования соединителя CICS
Действия для добавления соединительных элементов CICS в рабочий процесс логического приложения стандартного уровня

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

Системы CICS являются одной из первых критически важных систем, работающих на мейнфреймах. Сервер интеграции узлов Майкрософт (HIS) обеспечивает подключение к системам CICS с помощью TCP/IP, HTTP и APPC LU6.2. Клиенты использовали HIS Transaction Integrator для интеграции систем CICS с локальными системами Windows в течение многих лет. Соединитель вызовов программы CICS использует модели программирования TCP/IP и HTTP для взаимодействия с программами транзакций CICS.

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

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

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

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

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

Параметр	Обязательно	Тип	Описание
Имя HIDX	Да	Струна	Выберите файл HIDX CICS, который вы хотите использовать.
Имя метода	Да	Струна	Выберите метод в файле HIDX, который вы хотите использовать.
Дополнительные параметры	нет	Меняется	Этот список отображается после выбора метода, чтобы можно было добавить другие параметры для использования с выбранным методом. Доступные параметры зависят от выбранного файла HIDX и выбранного метода.

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

Предпосылки

Учетная запись и подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.
Доступ к мейнфрейму, на котором размещена система CICS.
XML-файл конструктора интеграции узлов (HIDX), предоставляющий необходимые метаданные для соединителя вызовов программы CICS для выполнения вашей программы на мейнфрейме.

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

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

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

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

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

Ограничения

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

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

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

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

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

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

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

Добавление действия CICS

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

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

Этот пример продолжается с триггером запроса с именем При получении HTTP-запроса:
Чтобы добавить операцию соединителя CICS, выполните следующие общие шаги, чтобы добавить встроенную операцию соединителя CICS с именем Call a CICS Program.

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

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

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

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

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

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

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

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

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

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

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

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

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

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