Desenvolvimento de um fluxo de mensagens com um nó CICSRequest

Para conectar-se a um aplicativo CICS® Transaction Server for z/OS® , crie um fluxo de mensagens que contém um nó CICSRequest .

1. Crie um fluxo de mensagens.
2. Adicionar um nó CICSRequest para o fluxo de mensagens.
3. Configure as propriedades a seguir no nó CICSRequest .
   • Servidor CICS: a propriedade Servidor CICS pode ser definida como um nome da política, por exemplo myCICSConnection ou como uma URL.

     Você pode se conectar ao CICS usando o modelo de conexão de duas camadas; por exemplo, estabelecendo uma conexão direta de IBM® App Connect Enterprise para CICS, ou usando o modelo de conexão de três camadas; por exemplo, conectando-se ao CICS através do CICS Transaction Gateway. Para obter mais informações sobre os modelos de conexão de duas e três camadas, consulte a visão geral em CICS Transaction Server for z/OS para uma visão geral de alto nível, ou CICS Transaction Server for z/OS (conectividade de duas camadas) e CICS Transaction Server for z/OS (conectividade de três camadas) para informações conceituais detalhadas.

     Usando o modelo de conexão de duas camadas:

     Se você estiver estabelecendo uma conexão direta de dois níveis de IBM App Connect Enterprise para CICS, poderá definir a propriedade do servidor CICS como um nome de política, por exemplo, myCICSConnection, ou como um URL.

     Para obter mais informações sobre como definir essa propriedade como uma política, consulte Alterando as Informações de Conexão para o Nó CICSRequest

     Para definir um URL, especifique o protocolo, o nome do host e o número da porta CICS nome do host e o número da porta. O formato desse valor é protocol://hostname:port. Em que:

     • protocol pode ser tcp ou ssl.
     • O nome do host é o endereço TCP/IP do host CICS.
     • port é o número da porta do ouvinte TCPIPSERVICE no endereço CICS, que está à escuta de solicitações IPIC através dos endereços TCP/IP ou SSL.

     Por exemplo: tcp://mycicsregion.com:12345 ou ssl://mycicsregion.com:56789. É possível obter os valores hostname e port da definição IPIC TCPIPSERVICE na região CICS de destino.

     Usando o modelo de conexão de três camadas:

     Se você estiver fazendo uma conexão de três camadas com CICS por meio de CICS Transaction Gateway, a propriedade do nó Servidor CICS CICSRequest deverá ser definida como um nome de política, por exemplo myCICSConnection.

     Para obter mais informações sobre como definir essa propriedade como uma política, consulte Alterando as Informações de Conexão para o Nó CICSRequest

     Para fazer uma conexão de três camadas com CICS por meio de CICS Transaction Gateway você deve configurar o servidor CICS e as propriedades da política de conexão CICS Transaction Gateway URL CICS (consulte CICS Política de conexão (CICSConnection) ).

   • Nome do programa: especifique o nome do programa que deseja executar na região CICS de destino.
     É possível substituir essa propriedade no ambiente local especificando um valor no seguinte local:

     $LocalEnvironment/Destination/CICS/CICSProgramName

   • Estrutura de dados: Especifica se deve ser usada uma estrutura de dados de canal ou COMMAREA. O padrão para essa propriedade é Commarea. A decisão depende do programa de destino do CICS , por exemplo; se o programa de destino é baseado em canal ou não.
   • Comprimento da Commarea:

     Essa propriedade não será configurável se um valor de Canal for selecionado para a propriedade Estrutura de Dados.

     A propriedade Comprimento de Commarea é o tamanho, em bytes, do COMMAREA usado pelo programa CICS . O valor do tamanho do byte é enviado para o CICSe antes que o programa seja iniciado, uma área de memória é criada para corresponder a esse número. Por exemplo, se você enviar um valor de Comprimento da Commarea igual a 100, 100 bytes serão alocados. O programa acessa esta área como a DFHCOMMAREA.

     Assegure-se de que o valor da propriedade Comprimento da Commarea seja grande o suficiente para conter os dados da solicitação de entrada, ou os dados de resposta de saída, mas não exceda o valor máximo de 32767 bytes. Se o valor Comprimento de Commarea não for grande o suficiente para ser usado para os dados de resposta ou para os dados da solicitação, ocorrerá uma fuga de memória no CICS.

     O tamanho da COMMAREA não pode ser mudado pelo programa CICS .

     Se os dados do pedido serializados forem maiores que o Comprimento da Commarea, os dados serão truncados no Comprimento da Commarea.

     É possível obter o valor de Comprimento de Commarea do administrador ou desenvolvedor do CICS .

     É possível substituir essa propriedade no ambiente local especificando um valor no seguinte local:

     $LocalEnvironment/Destination/CICS/CICSCommareaLen

   • Modo de transação: Especificar se os pedidos para o nó CICSRequest são para gerenciado como transacional ou não transacional.
     • Se você selecionar Sim, o nó CICSRequest toma parte na transação local que é iniciada pelo nó de entrada do fluxo de mensagens.
     • Se você selecionar Não, o nó CICSRequest não terá parte na transação local que é iniciada pelo nó de entrada do fluxo de mensagens.
     • Se selecionar Automático, a transacionalidade da mensagem será herdada da configuração Modo de Transação no nó de entrada como o início do fluxo de mensagens. Por exemplo, se o fluxo de mensagens for acionado por um nó MQInput , o nó CICSRequest assume o modo de Transação que é configurado no nó MQInput . Por padrão, a propriedade do modo de Transação do nó CICSRequest é configurada como Automática.
4. Salve o fluxo de mensagens.
5. Implemente o fluxo de mensagens.