Para conectar-se a um aplicativo CICS Transaction
Server para z/OS, crie um
fluxo de mensagens que contém um nó CICSRequest.
Conclua as etapas a seguir para desenvolver
um fluxo de mensagens com um nó do CICSRequest.
- Crie um fluxo de mensagens.
- Inclua um nó CICSRequest
no fluxo de mensagens.
- 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.
- Salve o fluxo de mensagens.
- 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.