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

Aplica-se a: Aplicativos Lógicos do Azure (Standard)

Para acessar e executar aplicativos de mainframe IBM em sistemas IMS (Sistema de Gerenciamento de Informações) a partir de fluxos de trabalho Standard nos Aplicativos Lógicos do Azure, você pode usar o conector interno baseado em provedor de serviços Chamada de Programa IMS. O IMS oferece um Monitor de TP (Programa de Transações) com um TM (Gerenciador de Transações) integrado e um banco de dados hierárquico. O conector se comunica com programas de transação do IBM IMS usando o IMS Connect, que é um componente de rede TM do IMS. Esse 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 do Azure Logic Apps, exceto no Azure Government e no Microsoft Azure operado pela 21Vianet.

Este artigo descreve os seguintes aspectos sobre o conector do IMS:

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

Examinar os cenários de uso do conector

Os sistemas IMS foram um dos primeiros sistemas críticos a serem executados em mainframes. O Microsoft Host Integration Server (HIS) fornece conectividade com sistemas IMS seguindo dois modelos: IMS Connect e APPC LU6.2. Os clientes têm usado o Integrador de Transações HIS para integrar seus sistemas IMS ao Windows local por muitos anos. O IMS Program Call connector usa o modelo IMS Connect para interagir com programas de transação IMS por meio de TCP/IP.

O diagrama a seguir mostra como o conector do 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 Standard funciona com o HIS Designer para Aplicativos Lógicos, que você pode usar para criar uma definição de programa ou um mapa de programa do programa de transação do mainframe. Para essa tarefa, o Designer HIS 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 Designer HIS, você pode adicionar esse arquivo como um artefato de mapa ao recurso de Aplicativo de Lógica Standard. Dessa forma, seu fluxo de trabalho pode acessar os metadados do aplicativo ao adicionar 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 em seu fluxo de trabalho. Em seguida, você pode fornecer parâmetros para o aplicativo host e o conector retorna os resultados para o fluxo de trabalho. Como resultado, você pode integrar seus aplicativos herdados ao Azure, à Microsoft, a outros aplicativos, serviços e sistemas aos quais os Aplicativos Lógicos do Azure dão suporte.

Referência técnica do conector

Atualmente, uma operação está disponível para o conector IMS: Chamar um programa IMS. A tabela a seguir resume o uso desta ação:

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

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tiver uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.

• 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 Chamada de Programa IMS execute o programa do mainframe.

  Para criar esse arquivo HIDX, baixe e instale o Designer do HOST Integration Server (HIS) para Aplicativos Lógicos do Azure. 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 retornados do programa mainframe. O conector do IMS gerencia o processo e as conversões de dados. Essas conversões fornecem dados de entrada do fluxo de trabalho para o programa mainframe e enviam todos os dados de saída gerados do programa 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 Designer HIS para Aplicativos Lógicos. Com essa ferramenta, você pode criar manualmente os métodos, os parâmetros e os valores retornados que podem ser usados no fluxo de trabalho. A ferramenta também permite importar definições de programa COBOL ou RPG (copybooks) que fornecem essas informações.

  A ferramenta gera um arquivo HIDX (Host Integration Designer XML) que fornece os metadados necessários para o conector. Se você estiver usando HIS, poderá usar o Designer do TI (Integrador de Transações) HIS para criar o arquivo HIDX.

• O fluxo de trabalho do aplicativo lógico Standard a ser usado para integração com o sistema IMS.

  O conector IMS não tem gatilhos, portanto, use qualquer gatilho para iniciar o 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 de aplicativo lógico Standard.

Limitações

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

Definir e gerar metadados

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

Carregar o arquivo HIDX

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

1. Vá para a pasta na qual você salvou o arquivo HIDX e copie o arquivo.

2. No portal do Azure, carregue o arquivo HIDX como um mapa para o recurso de aplicativo lógico Standard.

3. Continue para a próxima seção para adicionar uma ação do IMS ao fluxo de trabalho.

Posteriormente neste artigo, quando você adicionar uma ação do conector de Chamada de Programa IMS ao seu fluxo de trabalho pela primeira vez, uma solicitação pedirá que você crie uma conexão entre o 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 do IMS

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

1. No portal do Azure, abra o recurso de aplicativo lógico Standard e o fluxo de trabalho no designer.

2. Se você não tiver um gatilho para iniciar o fluxo de trabalho, siga estas etapas para adicionar o gatilho desejado.

   Este exemplo continua com o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida:

   

3. Para adicionar uma ação do conector IMS, siga estas etapas para adicionar a ação do conector interno da Chamada de Programa IMS nomeada Chamar um Programa IMS.

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

   Parâmetro	Obrigatório	Value	Description
   Nome da conexão	Yes	< nome da conexão>	O nome para a sua conexão.
   A ID do sistema IMS	Yes	< ID do sistema IMS>	O nome do sistema IMS onde o modelo IMS Connect direciona as solicitações recebidas.
   Nome de saída do ITOC	Não	< ITOC-exit-name>	O nome da rotina de saída que o IMS usa para lidar com solicitações recebidas.
   Nome do mod do MFS	Não	< MFS-Mod-Name>	O nome associado ao descritor de saída da mensagem IMS.
   Utilize a saída de segurança do HWSO1	Não	Verdadeiro ou falso	Direcione o servidor para usar a saída de segurança do HWSO1.
   Nome comum do certificado do servidor	Não	< server-cert-common-name>	O nome do certificado TLS (Camada de Segurança de Transporte) a ser usado.
   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 o texto.
   Senha	Não	< senha>	A senha de usuário opcional para autenticação de conexão.
   Número da porta	Yes	< número da porta>	O número da porta a ser usado para autenticação de conexão.
   Nome do Servidor	Yes	< 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 usuário	Não	< nome de usuário>	O nome de usuário opcional para autenticação de conexão.
   Usar TLS	Não	Verdadeiro ou falso	Proteja a conexão com a TLS (Camada de Segurança de Transporte).
   Validar certificado do servidor	Não	Verdadeiro ou falso	Valide o certificado do servidor.

   Por exemplo:

   

5. Quando terminar, selecione Criar Novo.

6. 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	Value	Description
   Nome HIDX	Yes	< HIDX-file-name>	Selecione o arquivo HIDX do IMS que você deseja usar.
   Nome do Método	Yes	< nome do método>	Selecione o método no arquivo HIDX que você deseja usar.
   Parâmetros avançados	Não	Varia	Essa lista é exibida depois que você seleciona um método para que você possa adicionar outros parâmetros a serem usados com o método selecionado. Os parâmetros disponíveis variam de acordo com o arquivo HIDX e o método selecionado.

   Por exemplo:

   Selecionar o arquivo e o método HIDX

   

   Selecionar parâmetros avançados

   

7. Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Testar seu fluxo de trabalho

Siga estas etapas para verificar o fluxo de trabalho e confirmar as saídas:

1. Para executar o fluxo de trabalho, na barra de ferramentas do designer, 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 verificação, enquanto as etapas malsucedidas mostram um ponto de exclamação (!).

2. Para examinar as entradas e saídas de cada etapa, expanda essa etapa.

3. Para examinar as saídas, selecione Ver saídas brutas.

Conteúdo relacionado

• Verificar o status do fluxo de trabalho, exibir o histórico de execuções e configurar alertas nos Aplicativos Lógicos do Azure
• Exibir métricas para integridade e desempenho do fluxo de trabalho nos Aplicativos Lógicos do Azure
• Monitorar e coletar dados de diagnóstico para fluxos de trabalho nos Aplicativos Lógicos do Azure
• Habilitar e exibir telemetria aprimorada no Application Insights para fluxos de trabalho Standard nos Aplicativos Lógicos do Azure