Integrar programas IMS em mainframes IBM com fluxos de trabalho Standard em Aplicativos Lógicos do Azure

Artigo
10/01/2024

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

Para acessar e executar aplicativos de mainframe IBM em sistemas IMS (Information Management System) a partir de fluxos de trabalho padrão em Aplicativos Lógicos do Azure, 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 dos Aplicativos Lógicos do Azure, exceto no Azure Government e no Microsoft Azure operados pela 21Vianet.

Este guia de instruções descreve os seguintes aspetos sobre o conector IMS:

Por que 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

Porquê usar este conector?

Os sistemas IMS foram um dos primeiros sistemas de missão crítica executados 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 (TI) para integrar seus sistemas IMS com o Windows no local há muitos anos. O conector de chamada de programa IMS usa o modelo IMS Connect para interagir com programas de transação IMS através de 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 arquivo de metadados do recurso do aplicativo lógico e apresenta dinamicamente os parâmetros a serem usados com o conector IMS no fluxo de trabalho. Em seguida, você pode fornecer parâmetros para o aplicativo host e o conector retorna os resultados para seu fluxo de trabalho. Como resultado, você pode integrar seus aplicativos herdados com o Azure, a Microsoft, outros aplicativos, serviços e sistemas suportados pelos Aplicativos Lógicos do Azure.

Referência técnica do conector

A seção a seguir descreve as operações para o conector IMS, que atualmente inclui apenas a seguinte ação:

Ligue para um programa IMS

Parâmetro	Necessário	Tipo	Description
Nome HIDX	Sim	String	Selecione o arquivo IMS HIDX que você deseja usar.
Nome do método	Sim	String	Selecione o método no arquivo HIDX que você deseja usar.
Parâmetros avançados	Não	Varia	Essa lista aparece depois que você seleciona um método para que você possa adicionar outros parâmetros para usar com o método selecionado. Os parâmetros disponíveis variam com base no seu arquivo HIDX e no método selecionado.

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

Limitações

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

Pré-requisitos

Uma conta e subscrição do Azure. 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 HIS Designer for Azure Logic Apps. O único pré-requisito é o Microsoft .NET Framework 4.8.

Para invocar um programa de mainframe, seu fluxo de trabalho precisa entender o tipo, os parâmetros e os valores de retorno do programa de mainframe. O conector IMS gerencia o processo e as conversões de dados, que são necessárias para fornecer dados de entrada do fluxo de trabalho para o programa de mainframe e para enviar 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 página de código. Para esse processo, os Aplicativos Lógicos do Azure exigem que você forneça essas 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 arquivo XML do Host Integration Designer (HIDX) que fornece os metadados necessários para o conector. Se você estiver usando o HIS, poderá usar o TI Designer para criar o arquivo 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, você pode 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.

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.
Agora, adicione uma ação IMS ao seu fluxo de trabalho.

Mais adiante neste guia, quando você adiciona uma ação de conector de chamada de programa IMS ao seu fluxo de trabalho pela primeira vez, você é solicitado a criar uma conexão entre seu fluxo de trabalho e o sistema de mainframe. Depois de criar a conexão, você pode selecionar o arquivo HIDX adicionado anteriormente, o método a ser executado e os parâmetros a serem usados.

Adicionar uma ação IMS

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

Este exemplo continua com o gatilho Request chamado When a HTTP request is received.
Para adicionar uma ação de conector IMS, siga estas etapas gerais para adicionar a ação de conector interno de chamada de programa IMS chamada de programa IMS.

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

Parâmetro	Necessário	Valor	Description
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 lidar com solicitações de entrada
MFS Mod Nome	Não	<MFS-Mod-Nome>	O nome associado ao descritor de saída de mensagem IMS de saída
Usar a saída de segurança HWSO1	Não	Verdadeiro ou falso	O servidor usa a saída de segurança HWSO1.
Nome comum do certificado do servidor	Não	<servidor-cert-common-name>	O nome do certificado TLS (Transport Security layer) a ser usado
Página de código	Não	<página de código>	O número de página de código a ser usado para converter texto
Palavra-passe	Não	<palavra-passe>	A senha de usuário opcional para autenticação de conexão
Número da porta	Sim	<número da porta>	O número da porta a ser usado para autenticação de conexão
Nome do servidor	Sim	<nome-do-servidor>	O nome do servidor
Tempo limite	Não	<tempo limite>	O período de tempo limite em segundos enquanto aguarda respostas do servidor
Nome de Utilizador	Não	<nome de utilizador>	O nome de usuário opcional para autenticação de conexão
Usar TLS	Não	Verdadeiro ou falso	Proteja a conexão com Transport Security Layer (TLS).
Validar certificado do servidor	Não	Verdadeiro ou falso	Valide 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	Necessário	Valor	Description
Nome HIDX	Sim	<Nome do ficheiro HIDX>	Selecione o arquivo IMS HIDX que você deseja usar.
Nome do método	Sim	<nome-método>	Selecione o método no arquivo HIDX que você deseja usar.
Parâmetros avançados	Não	Varia	Essa lista aparece depois que você seleciona um método para que você possa adicionar outros parâmetros para usar com o método selecionado. Os parâmetros disponíveis variam com base no seu arquivo HIDX e no método selecionado.

Por exemplo:

Selecione o arquivo e o método HIDX

Selecionar parâmetros avançados

Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Salvar.

Testar o fluxo de trabalho

Para executar seu fluxo de trabalho, no menu de fluxo de trabalho, selecione Visão geral. Na barra de ferramentas Visão geral, selecione Executar>execução.

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.

Partilhar via