Integrar programas CICS 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 CICS (Customer Information Control System) a partir de fluxos de trabalho padrão no Aplicativos Lógicos do Azure, você pode usar o conector integrado baseado em provedor de serviços do CICS Program Call. O CICS fornece um Monitor de TP (Programa de Transação) com um TM (Gerenciador de Transações) integrado. O conector se comunica com programas de transação IBM CICS usando TCP/IP. O conector CICS está disponível em todas as regiões dos Aplicativos Lógicos do Azure, exceto no Azure Governamental e no Microsoft Azure operado pela 21Vianet.

Este artigo descreve os seguintes aspectos sobre o conector CICS:

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

Examinar os cenários de uso do conector

Os sistemas CICS foram um dos primeiros sistemas críticos que são executados em mainframes. O Microsoft Host Integration Server (HIS) fornece conectividade com sistemas CICS usando TCP/IP, HTTP e APPC LU6.2. Os clientes têm usado o Integrador de Transações HIS para integrar sistemas CICS ao Windows local por muitos anos. O conector de Chamada do Programa CICS usa modelos de programação TCP/IP e HTTP para interagir com programas de transação CICS.

O diagrama a seguir mostra como o conector CICS interage com um sistema de mainframe ibm:

Para estender esses cenários de nuvem híbrida, o conector CICS em um fluxo de trabalho Padrão funciona com o HIS Designer for Aplicativos Lógicos do Azure, que você pode usar para criar uma definição de programa ou mapa de programa do programa de transação do mainframe. Para essa tarefa, o Designer HIS usa um modelo de programação que determina as características da troca de dados entre o mainframe e o fluxo de trabalho. O Designer HIS converte essas informações em metadados que o conector CICS 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 CICS. O conector lê o arquivo de metadados do recurso de aplicativo lógico e apresenta dinamicamente parâmetros a serem usados com o conector CICS 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 CICS: Chamar um programa CICS. A tabela a seguir resume o uso desta ação:

Parâmetro	Obrigatório	Tipo	Description
Nome HIDX	Yes	String	Selecione o arquivo CICS HIDX que você deseja usar.
Nome do Método	Yes	String	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.

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 CICS.
O arquivo HIDX (Host Integration Designer XML) que fornece os metadados necessários para que o conector Chamada de Programa CICS execute o programa do mainframe.

Para criar esse arquivo HIDX, baixe e instale o Designer 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 CICS gerencia esse processo e as conversões de dados. As 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, parâmetros e valores retornados 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 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 no qual você deseja se integrar ao sistema CICS.

O conector CICS 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 . Você pode então adicionar as ações do conector CICS. Para começar, crie um fluxo de trabalho em branco no recurso de aplicativo lógico Standard.

Limitações

Atualmente, o conector CICS exige que você carregue seu arquivo HIDX diretamente no recurso do aplicativo lógico padrão, 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:

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

Mais adiante nesse artigo, quando você adicionar uma ação de conector Chamada de Programa CICS ao seu fluxo de trabalho pela primeira vez, um prompt solicitará que você crie uma conexão entre seu fluxo de trabalho e o sistema 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 CICS

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

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

Este exemplo continua com o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida:
Para adicionar uma ação do conector CICS, siga essas etapas gerais para adicionar a ação do conector integrado Chamada de programa CICS chamada Chamar um programa CICS.

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

Parâmetro	Obrigatório	Value	Description
Nome da conexão	Yes	< nome da conexão>	O nome para a sua conexão.
Modelo de programação	Yes	< modelo-de-programação-CICS>	O modelo de programação CICS selecionado. Para obter mais informações, consulte Modelos de Programação.
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.
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.
Usar o Formato de Cabeçalho de Solicitação IBM	Não	Verdadeiro ou falso	Direcione o servidor a esperar cabeçalhos ELM ou TRM no formato IBM.

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	Value	Description
Nome HIDX	Yes	< HIDX-file-name>	Selecione o arquivo CICS HIDX 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

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:

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 (!).
Para examinar as entradas e saídas de cada etapa, expanda essa etapa.
Para examinar as saídas, selecione Ver saídas brutas.

Comentários

Esta página foi útil?

Last updated on 2025-10-08