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 guia de instruções descreve os seguintes aspetos sobre o conector IBM i:
Porquê utilizar o conector IBM i nas Aplicações Lógicas 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
Porquê usar este 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 Aplicativos Lógicos do Azure, 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 (TI) para integrar sistemas IBM i e Windows no local. 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 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. 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 IBM i, que atualmente inclui apenas a seguinte ação:
Chamar um programa IBM i
| Parâmetro | Necessário | Type | Description |
|---|---|---|---|
| Nome HIDX | Sim | String | Selecione o ficheiro IBM i HIDX que pretende utilizar. |
| 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 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 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 gerencia esse processo e conversões de dados, que são necessárias para fornecer dados de entrada do fluxo de trabalho para o programa midrange e para enviar 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 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ê usa em seu fluxo de trabalho. Você também pode importar definições de programa 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 da aplicação lógica Standard onde pretende integrar 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.
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.
Mais adiante neste guia, quando você adiciona uma ação do conector de Chamada de Programa do IBM i ao seu fluxo de trabalho pela primeira vez, você será solicitado a criar uma conexão entre seu fluxo de trabalho e o sistema midrange. 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 IBM i
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 IBM i, siga estes passos gerais para adicionar a ação de conector integrada IBM i Program Call denominada Chamar um Programa IBM i.
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 Necessário Valor Description Nome da Ligação Sim <nome da conexão> O nome da sua ligação 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 ficheiro IBM i HIDX que pretende utilizar. 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 tiver terminado, guarde o 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.
Próximos passos
- Monitore o status de execução do fluxo de trabalho, revise o disparador e o histórico de execução do fluxo de trabalho e configure 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