Integrar programas IMS em mainframes da IBM com fluxos de trabalho Standard no Azure Logic Apps

2025-04-17

Aplica-se a: Aplicativos Lógicos do Azure (Padrão)

Para aceder e executar aplicativos de mainframe IBM em sistemas IMS (Information Management System) a partir de fluxos de trabalho padrão em Azure Logic Apps, você pode usar o conector interno baseado em provedor de serviços IMS Program Call. O IMS fornece um Monitor de Programa de Transações (TP) com um Transaction Manager (TM) integrado e banco de dados hierárquico. O conector se comunica com programas de transação IBM IMS usando o IMS Connect, que é um componente de rede IMS TM. Este componente fornece comunicações de alto desempenho para sistemas IMS entre um ou mais clientes TCP/IP e um ou mais sistemas IMS. O conector IMS está disponível em todas as regiões de Aplicativos Lógicos do Azure, exceto no Azure Government e no Microsoft Azure operado pela 21Vianet.

Este artigo descreve os seguintes aspetos sobre o conector IMS:

Cenários para usar o conector IMS nos Aplicativos Lógicos do Azure
Pré-requisitos e configuração para usar o conector IMS
Etapas para adicionar ações do conector IMS ao fluxo de trabalho do aplicativo lógico padrão

Revise os cenários de uso do conector

Os sistemas IMS foram um dos primeiros sistemas de missão crítica a funcionar em mainframes. Microsoft Host Integration Server (HIS) fornece conectividade para sistemas IMS seguindo dois modelos: IMS Connect e APPC LU6.2. Os clientes usam o HIS Transaction Integrator para integrar seus sistemas IMS com o Windows local há muitos anos. O conector IMS Program Call usa o modelo IMS Connect para interagir com programas de transação IMS via TCP/IP.

O diagrama a seguir mostra como o conector IMS interage com um sistema de mainframe IBM:

Para estender esses cenários de nuvem híbrida, o conector IMS em um fluxo de trabalho padrão funciona com o HIS Designer for Logic Apps, que você pode usar para criar uma definição de programa ou mapa de programa do programa de transação de mainframe. Para essa tarefa, o HIS Designer converte essas informações em metadados que o conector IMS usa ao executar uma ação em seu fluxo de trabalho.

Depois de gerar o arquivo de metadados como um arquivo HIDX (Host Integration Designer XML) do HIS Designer, você pode adicionar esse arquivo como um artefato de mapa ao recurso do aplicativo lógico padrão. Dessa forma, seu fluxo de trabalho pode acessar os metadados do aplicativo quando você adiciona uma ação do conector IMS. O conector lê o ficheiro de metadados do recurso da aplicação lógica e apresenta de forma dinâmica os parâmetros a serem usados com o conector IMS no fluxo de trabalho. Depois, pode fornecer parâmetros à aplicação anfitriã e o conector devolve os resultados ao seu fluxo de trabalho. As a result, you can integrate your legacy apps with Azure, Microsoft, other apps, services, and systems that Azure Logic Apps supports.

Referência técnica do conector

Atualmente, está disponível uma operação para o conector IMS: Chamar um programa IMS. The following table summarizes the usage for this action:

Parâmetro	Obrigatório	Tipo	Descrição
Nome HIDX	Sim	Cordão	Selecione o arquivo IMS HIDX que você deseja usar.
Nome do método	Sim	Cordão	Selecione o método no ficheiro HIDX que deseja usar.
Parâmetros avançados	Não	Varia	Esta lista aparece após selecionar um método, para que possa adicionar outros parâmetros a serem usados com o método selecionado. Os parâmetros disponíveis variam com base no seu ficheiro HIDX e no método que escolher.

Esta operação também inclui parâmetros avançados, que aparecem depois de selecionar um método, para que possa escolher e usar com o método selecionado. Esses parâmetros variam com base no seu ficheiro HIDX e no método que selecionar.

Pré-requisitos

Uma conta Azure e uma assinatura. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.
Acesso ao mainframe que hospeda o sistema IMS.
O arquivo HIDX (Host Integration Designer XML) que fornece os metadados necessários para que o conector de chamada de programa IMS execute seu programa de mainframe.

Para criar esse arquivo HIDX, baixe e instale o Host Integration Server (HIS) Designer para Aplicativos Lógicos do Azure. O único pré-requisito é o Microsoft .NET Framework 4.8.

Para invocar um programa mainframe, o seu fluxo de trabalho precisa entender o tipo, os parâmetros e os valores de retorno do programa mainframe. O conector IMS gerencia o processo e as conversões de dados. Essas conversões fornecem dados de entrada do fluxo de trabalho para o programa de mainframe e enviam quaisquer dados de saída gerados do programa de mainframe para o fluxo de trabalho. O conector também fornece definição de dados tabulares e tradução de código de página. Para este processo, o Azure Logic Apps requer que forneça estas informações como metadados.

Para criar esses metadados, use o HIS Designer for Logic Apps. Com essa ferramenta, você pode criar manualmente os métodos, parâmetros e valores de retorno que você pode usar em seu fluxo de trabalho. A ferramenta também permite importar definições de programas COBOL ou RPG (copybooks) que fornecem essas informações.

A ferramenta gera um ficheiro XML do Host Integration Designer (HIDX) que fornece os metadados necessários para o conector. Se estiver a usar HIS, pode usar o Designer do TI (Transaction Integrator) do HIS para criar o ficheiro HIDX.
O fluxo de trabalho do aplicativo lógico padrão a ser usado para integração com o sistema IMS.

O conector IMS não tem gatilhos, portanto, use qualquer gatilho para iniciar seu fluxo de trabalho, como o gatilho de Recorrência ou o gatilho de Solicitação . Em seguida, pode-se adicionar as ações do conector IMS. Para começar, crie um fluxo de trabalho em branco no recurso do aplicativo lógico padrão.

Limitações

Atualmente, o conector IMS requer que você carregue seu arquivo HIDX diretamente para o recurso do aplicativo lógico padrão, não para uma conta de integração.

Definir e gerar metadados

Depois de baixar e instalar o HIS Designer para Aplicativos Lógicos do Azure, siga estas etapas para gerar o arquivo HIDX a partir do artefato de metadados.

Carregue o arquivo HIDX

Para que seu fluxo de trabalho use o arquivo HIDX, siga estas etapas:

Vá para a pasta onde você salvou o arquivo HIDX e copie o arquivo.
No portal do Azure, carregue o arquivo HIDX como um mapa para seu recurso de aplicativo lógico padrão.
Continue para a próxima seção para adicionar uma ação IMS ao seu fluxo de trabalho.

Mais adiante neste artigo, quando adicionar pela primeira vez uma ação de conector de chamada do programa IMS ao seu fluxo de trabalho, uma mensagem solicitará que crie uma ligação entre o seu fluxo de trabalho e o sistema de mainframe. Após criar a ligação, pode selecionar o seu ficheiro HIDX previamente adicionado, o método a correr e os parâmetros a utilizar.

Adicionar uma ação IMS

Siga estas etapas para adicionar uma ação IMS e configurar os parâmetros necessários:

No portal Azure, abra o recurso do aplicativo lógico Standard e o fluxo de trabalho no designer.
Se você não tiver um gatilho para iniciar seu fluxo de trabalho, siga estas etapas para adicionar o gatilho desejado.

Este exemplo continua com o gatilho Request chamado Quando uma solicitação HTTP é recebida:
Para adicionar uma ação de conector IMS, siga estas etapas para adicionar a ação de conector incorporada Chamada de Programa IMS chamada Chamar um Programa IMS.

Depois que o painel de detalhes da conexão for exibido, forneça as seguintes informações:

Parâmetro	Obrigatório	Valor	Descrição
Nome da Ligação	Sim	< nome da conexão>	O nome da sua ligação.
O ID do sistema IMS	Sim	< ID do sistema IMS>	O nome do sistema IMS onde o modelo IMS Connect direciona as solicitações de entrada.
Nome de saída do ITOC	Não	< ITOC-nome de saída>	O nome da rotina de saída que o IMS usa para processar pedidos recebidos.
MFS Mod Nome	Não	< MFS-Mod-Nome>	O nome associado ao descritor de saída de mensagem IMS.
Usar a saída de segurança HWSO1	Não	Verdadeiro ou falso	Direcione o servidor para usar a saída de segurança HWSO1.
Nome comum do certificado de servidor	Não	< server-cert-common-name>	O nome do certificado da camada de Segurança de Transporte (TLS) a utilizar.
Página de código	Não	< página de código>	O número da página de código a ser usado para converter texto.
Senha	Não	< palavra-passe>	A palavra-passe de utilizador opcional para autenticação da ligação.
Port Number	Sim	< port-number>	O número da porta a ser utilizado para a autenticação da ligação.
Nome do Servidor	Sim	< server-name>	O nome do servidor.
Tempo limite	Não	< tempo limite>	O período de espera em segundos enquanto se aguarda respostas do servidor.
Nome de Utilizador	Não	< nome de utilizador>	O nome de utilizador opcional para autenticação de ligação.
Use TLS	Não	True or false	Secure the connection with Transport Security Layer (TLS).
Validar certificado do servidor	Não	Verdadeiro ou falso	Validar o certificado do servidor.

Por exemplo:

Quando terminar, selecione Criar novo.

Depois que o painel de detalhes da ação for exibido, na seção Parâmetros , forneça as informações necessárias:

Parâmetro	Obrigatório	Valor	Descrição
Nome HIDX	Sim	< Nome do ficheiro HIDX>	Selecione o arquivo IMS HIDX que você deseja usar.
Nome do método	Sim	< method-name>	Selecione o método no ficheiro HIDX que pretende usar.
Parâmetros avançados	Não	Depende	Esta lista aparece após selecionar um método, permitindo que adicione outros parâmetros para usar com o método selecionado. The available parameters vary based on your HIDX file and the method that you select.

Por exemplo:

Selecione o ficheiro HIDX e o método

Selecionar parâmetros avançados

Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Testar o fluxo de trabalho

Siga estes passos para verificar o seu fluxo de trabalho e confirmar os resultados:

Para executar seu fluxo de trabalho, na barra de ferramentas do designer, selecione Executar>Executar.

Depois que o fluxo de trabalho terminar de ser executado, o histórico de execução do fluxo de trabalho será exibido. As etapas bem-sucedidas mostram marcas de seleção, enquanto as etapas malsucedidas mostram um ponto de exclamação (!).
Para revisar as entradas e saídas de cada etapa, expanda essa etapa.
Para rever as saídas, selecione Ver saídas brutas.