WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Desenvolvendo um Fluxo de Mensagens com um Nó CICSRequest

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

Antes de começar:
Assegure-se de que você tenha concluído as seguintes tarefas:
  1. Defina a estrutura de dados COMMAREA ou de canal, conforme descrito em Definindo uma Estrutura de Dados do CICS Transaction Server para z/OS.
  2. Opcional: Se você estiver usando uma estrutura de dados de canal, crie uma coleção de mensagens para representar a estrutura de dados de canal, conforme descrito em Criando uma Coleção de Mensagens Usando ESQL.
  3. Configure o protocolo IP InterCommunications (IPIC) no CICS, como descrito em Preparando o Ambiente para o Nó CICSRequest.
  4. Opcional: Configure o nó CICSRequest para comunicação com o CICS Transaction Server para z/OS sobre o protocolo Secure Sockets Layer (SSL), conforme descrito em Protegendo a Conexão Para CICS Transaction Server para z/OS Utilizando SSL.
Conclua as etapas a seguir para desenvolver um fluxo de mensagens com um nó do CICSRequest.
  1. Crie um fluxo de mensagens.
  2. Inclua um nó CICSRequest no fluxo de mensagens.
  3. Configure as propriedades a seguir no nó de CICSRequest.
    • Servidor CICS: A propriedade de servidor CICS pode ser definida como um nome de serviço configurável, por exemplo, myCICSConnection, ou como uma URL.

      Você pode conectar-se ao CICS usando o modelo de conexão de duas camadas; por exemplo, fazendo uma conexão direta do WebSphere Message Broker com o 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 Multiplataformas. Para obter mais informações sobre os modelos de conexão de duas e três camadas, consulte Visão Geral do CICS Transaction Server para z/OS para obter uma visão geral resumida, ou Conectividade de Duas Camadas do CICS Transaction Server para z/OS e Conectividade de Três Camadas do CICS Transaction Server para z/OS para obter informações conceituais detalhadas.

      Usando o modelo de conexão de duas camadas:
      Se você estiver fazendo uma conexão direta de duas camadas do WebSphere Message Broker para o CICS, poderá definir a propriedade de servidor CICS como um nome de serviço configurável, por exemplo, myCICSConnection, ou como uma URL.

      Para obter informações adicionais sobre como definir esta propriedade como um serviço configurável, consulte Alterando Informações de Conexão para o Nó CICSRequest.

      Para definir uma URL, especifique o protocolo e o nome do host e o número da porta do CICS. O formato desse valor é protocol://hostname:port. Em que:
      • protocol pode ser tcp ou ssl.
      • hostname é o endereço TCP/IP do host CICS.
      • port é o número da porta do listener TCPIPSERVICE no CICS que está atendendo para pedidos IPIC sobre TCP/IP ou SSL.
      Por exemplo: tcp://mycicsregion.com:12345 ou ssl://mycicsregion.com:56789. É possível obter os valores de hostname e port a partir da definição de IPIC TCPIPSERVICE na região CICS de destino.
      Usando o modelo de conexão de três camadas:
      Se você estiver estabelecendo uma conexão de três camadas com o CICS através do CICS Transaction Gateway para Multiplataformas, a propriedade de servidor CICS do nó CICSRequest deverá ser definida como um nome de serviço configurável, por exemplo, myCICSConnection.

      Para obter informações adicionais sobre como definir esta propriedade como um serviço configurável, consulte Alterando Informações de Conexão para o Nó CICSRequest.

      Para estabelecer uma conexão de três camadas com o CICS através do CICS Transaction Gateway para Multiplataformas, você deve configurar as propriedades cicsServer e gatewayURL do serviço configurável CICSConnection. Para obter mais informações sobre a configuração das propriedades cicsServer e gatewayURL do serviço configurável CICSConnection para estabelecer uma conexão de três camadas, consulte Propriedades de Serviços Configuráveis.

    • Nome do Programa: Especifique o nome do programa que deseja executar na região CICS de destino.
      Você pode 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 CICS de destino, 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 da Commarea é o tamanho, em bytes, da COMMAREA que é usada pelo programa CICS. O valor do tamanho do byte é enviado para o CICS, e antes de o programa ser iniciado, uma área da 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 de Comprimento da Commarea não for grande o suficiente para ser utilizado para os dados de resposta ou dados do pedido, ocorrerá uma fuga de memória no CICS.

      O tamanho da COMMAREA não pode ser alterado 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 Comprimento da Commarea do administrador ou desenvolvedor do CICS.

      Você pode substituir essa propriedade no ambiente local especificando um valor no seguinte local:
      $LocalEnvironment/Destination/CICS/CICSCommareaLen
    • Modo de Transação: Especifique se as solicitações para o nó CICSRequest devem ser gerenciadas como transacionais ou não transacionais.
      • Se selecionar Sim, o nó CICSRequest faz parte da transação local que é iniciada pelo nó de entrada do fluxo de mensagens.
      • Se selecionar Não, o nó CICSRequest não faz parte da transação local que é iniciada pelo nó de entrada do fluxo de mensagens.
      • Se você selecionar Automático, a transacionalidade da mensagem será herdada da configuração Modo de Transação no nó Entrada como o início do fluxo de mensagens. Por exemplo, se o fluxo de mensagens for conduzido por um nó MQInput, o nó CICSRequest assumirá o modo Transação que está configurado no nó MQInput. Por padrão, a propriedade Modo de Transação do nó CICSRequest está configurada como Automático.

      Para obter informações adicionais sobre transacionalidade, consulte Transações de Fluxos de Mensagens.

  4. Salve o fluxo de mensagens.
  5. Implemente o fluxo de mensagens.
A seguir: Quando tiver criado e configurado o fluxo de mensagens, construa uma mensagem seguindo as etapas em Construindo uma Mensagem para o Nó CICSRequest.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:43


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | bc16070_