Integre programas COBOL e RPG em sistemas midrange IBM com fluxos de trabalho Standard em Aplicativos Lógicos do Azure

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

Para aceder e executar programas COBOL e RPG em sistemas IBM midrange a partir de fluxos de trabalho Standard nas Aplicações Lógicas do Azure, é possível utilizar o conector integrado baseado no fornecedor de serviços IBM i Program Call . O sistema operativo IBM i fornece um servidor DPC (Distributed Program Calls). O conector se comunica com o servidor IBM i DPC para executar programas COBOL e RPG usando TCP/IP. O conector IBM i 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 artigo descreve os seguintes aspetos sobre o conector IBM i:

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

Revise os cenários de uso do conector

Há mais de 50 anos, a IBM lançou os primeiros sistemas midrange. A IBM anunciou-os como "Pequenos em tamanho, pequenos em preço e grandes em desempenho. É um sistema para o presente e para o futuro." Ao longo dos anos, os sistemas midrange evoluíram e se tornaram generalizados em empresas de médio porte ou em grandes empresas para estender ambientes de mainframe. Os sistemas midrange que executam o IBM i, normalmente Power Systems, suportam TCP/IP e SNA.

O sistema IBM i inclui o recurso de servidor DPC que permite que a maioria dos aplicativos IBM i interaja com clientes como o Azure Logic Apps usando o padrão somente solicitação-resposta iniciado pelo cliente com modificações mínimas. O DPC é um protocolo documentado que suporta a integração programa-a-programa num sistema IBM i, ao qual as aplicações cliente podem aceder facilmente utilizando o protocolo de rede TCP/IP.

O Microsoft Host Integration Server (HIS) fornece conectividade a sistemas IBM i usando TCP/IP e APPC LU6.2. Por muitos anos, os clientes usaram o HIS Transaction Integrator para integrar sistemas IBM i locais e Windows. O conector IBM i Program Call utiliza o modelo de programação TCP/IP para interagir com programas IBM i COBOL e RPG.

O diagrama a seguir mostra como o conector IBM i interage com um sistema IBM i:

Para estender esses cenários de nuvem híbrida, o conector IBM i em um fluxo de trabalho Standard funciona com o HIS Designer for Logic Apps, que pode ser usado para criar uma definição de programa ou mapa de programa do programa COBOL ou RPG. Para esta tarefa, o HIS Designer usa um modelo de programação que determina as características da troca de dados entre o midrange e o fluxo de trabalho. O HIS Designer converte essas informações em metadados que o conector IBM i 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 seu aplicativo quando você adiciona uma ação de conector do IBM i. 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 IBM i em seu fluxo de trabalho. Depois, pode fornecer parâmetros à aplicação anfitriã e o conector devolve os resultados ao seu fluxo de trabalho. Como resultado, pode integrar as suas aplicações legadas com o Azure, Microsoft, outras aplicações, serviços e sistemas suportados pelo Azure Logic Apps.

Referência técnica do conector

Atualmente, uma operação está disponível para o conector IBM i: Chamar um programa IBM i. A tabela seguinte resume a utilização desta ação.

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 servidor midrange que hospeda o sistema IBM i.

• O ficheiro Host Integration Designer XML (HIDX) que fornece os metadados necessários para que o conector IBM i Program Call execute o seu programa midrange.

  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 midrange, seu fluxo de trabalho precisa entender o tipo, os parâmetros e os valores de retorno do programa midrange. O conector IBM i gere este processo e as conversões de dados. Essas conversões necessárias fornecem dados de entrada do fluxo de trabalho para o programa midrange e enviam quaisquer dados de saída gerados do programa midrange 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 esta ferramenta, pode criar manualmente os métodos, parâmetros e valores de retorno que usa no seu fluxo de trabalho. Também pode importar definições de programas COBOL ou RPG (copybooks) que forneçam esta informação.

  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 da aplicação de lógica padrão no qual pretende integrar-se com o sistema IBM i.

  O conector IBM i 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, é possível adicionar a ação do conector do IBM i. Para começar, crie um fluxo de trabalho em branco no recurso do aplicativo lógico padrão.

Limitações

Atualmente, o conector IBM i requer que você carregue seu arquivo HIDX diretamente para o recurso do aplicativo lógico padrão, não 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:

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

2. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

3. No menu do aplicativo lógico, em Artefatos, carregue o arquivo HIDX como um mapa para o recurso do aplicativo lógico.

4. Continue para a próxima seção para adicionar uma ação do IBM i ao seu fluxo de trabalho.

Mais adiante neste guia, quando o utilizador adicionar pela primeira vez uma ação do conector IBM i Program Call ao seu fluxo de trabalho, será solicitado que crie uma conexão entre o seu fluxo de trabalho e o sistema de gama média. 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 do IBM i

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

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

2. Se você não tiver 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 Quando uma solicitação HTTP é recebida:

   

3. Para adicionar uma ação de conector IBM i, siga estes passos gerais para adicionar a ação de conector integrada IBM i Program Call denominada Chamar um Programa IBM i.

4. Depois que o painel de detalhes da conexão for exibido, forneça as seguintes informações, como o nome do servidor host e as informações de configuração do sistema IBM i:

   Parâmetro	Obrigatório	Valor	Descrição
   Nome da Ligação	Sim	< nome da conexão>	O nome da sua ligação.
   Nome comum do certificado de servidor	Não	< servidor-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 para usar na conversão de texto.
   Senha	Não	< palavra-passe>	A palavra-passe de utilizador opcional para autenticação da ligação.
   Número da porta	Sim	< número da porta>	O número da porta a ser utilizado para a autenticação da ligação.
   Nome do Servidor	Sim	< nome-do-servidor>	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.
   Usar TLS	Não	Verdadeiro ou falso	Assegure a conexão com a Camada de Segurança de Transporte (TLS).
   Validar certificado do servidor	Não	Verdadeiro ou falso	Validar 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	Valor	Descrição
   Nome HIDX	Sim	< Nome do ficheiro HIDX>	Selecione o ficheiro IBM i HIDX que pretende utilizar.
   Nome do método	Sim	< nome-método>	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.

   Por exemplo:

   Selecione o ficheiro HIDX e o método

   

   Selecionar parâmetros avançados

   

7. 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:

1. 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. Os passos bem-sucedidos mostram símbolos de visto, enquanto os passos malsucedidos mostram um ponto de exclamação (!).

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

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

Conteúdo relacionado

• Verificar o status do fluxo de trabalho, exibir o histórico de execução e configurar alertas nos Aplicativos Lógicos do Azure
• Exibir métricas de 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 em fluxos de trabalho do Application Insights for Standard em Aplicativos Lógicos do Azure