![[z/OS]](../images/ngzos.gif)
Transações BBOC, BBO$, BBO# do WebSphere Application Server
Este tópico descreve como os adaptadores locais otimizados são suportados no produto Customer Information Control System (CICS), incluindo as transações do WebSphere Application Server que são introduzidas, como BBOC, BBO$ e BBO#.
O adaptador foi projetado para ser executado em uma região CICS como um gerenciador de recursos. No CICS, a Saída do Usuário Relacionada à Tarefa (TRUE) é o principal veículo para provedores de recursos. O suporte TRUE fornece o limite entre os encadeamentos de aplicativos CICS e os encadeamentos do gerenciador de recursos externo. Atualmente, os soquetes DB2, WebSphere MQ e TCP/IP são usados no CICS com o suporte TRUE. Os adaptadores locais otimizados suportam a TRUE.
Os aplicativos que são executados no CICS e exploram as APIs do adaptador local otimizado fazem isso chamando as rotinas de stub fornecidas. As rotinas de stub iniciam o módulo da interface do gerenciador de recursos CICS, transmitindo a ele o nome da rotina TRUE do adaptador local otimizado e os parâmetros específicos de cada API. O CICS despacha a TRUE em um dos TCBs OPENABI mantidos pelo CICS e é executado até a conclusão da chamada da API. A chamada então retorna ao CICS com os parâmetros de saída. O suporte da TRUE do CICS também fornece notificação sobre os limites de transação, como quando o aplicativo é encerrado normalmente, encerrado anormalmente ou emite uma chamada explícita SYNCPOINT para o CICS. Para obter detalhes sobre como este suporte é usado para propagação do contexto de transação para o WebSphere Application Server e para o two-phase commit, consulte a seção nesse tópico em "Propagando Transações". Além disso, para o CICS, é fornecido um programa Program List Table Post-Initialization (PLTPI), que pode ser usado para iniciar automaticamente o programa TRUE durante a inicialização do CICS. Se você não usar o PLTPI, será fornecida uma transação CICS, BBOC. Esta transação pode ser usada para iniciar, parar, ativar e desativar o rastreio para o módulo TRUE.
Transação de Controle BBOC do WebSphere Application Server para CICS
A transação BBOC é o controle do WebSphere, ou transação de operações para o suporte a adaptadores no CICS. Ela é usada para ativar e iniciar a TRUE do WebSphere Application Server e configurar níveis de rastreio para depurar as APIs e o código de interface do WebSphere Application Server. BBOC também configura registros e remoções de registros, inicia e para tarefas do servidor de Link do WebSphere Application Server no CICS. Estas tarefas de servidor fornecem suporte para iniciar programas CICS existentes e transmitir dados com COMMAREAs ou contêineres com os parâmetros de entrada sobre os adaptadores. Esta é uma transação baseada em terminal do CICS que pode ser emitida em um terminal 3270 ou a partir de um terminal sequencial, de tipo SDSCI. A sintaxe para o BBOC é descrita a seguir:
BBOC<operation_name><parameters_separated_by_one_or_more_spaces>.
- Nome do registro - RGN
O parâmetro RGN é o nome do registro de 12 caracteres.
- Nome do grupo do daemon - DGN
DGN é o nome do grupo de daemon com oito caracteres com o qual é feito o registro.
- Sincronização no retorno do link - LSYNC
O LSYNC controla se a opção SYNCONRETURN é usada ao vincular com o programa de destino no servidor de link. Quando LSYNC=Y, a opção SYNCONRETURN é passada para o CICS quando o programa de destino é vinculado e usa EXEC CICS LINK. Essa opção poderá ser necessária quando o programa de destino estiver em outra região do CICS. O valor padrão é LSYNC=N.
- Nome abreviado do nó - NDN
NDN é o nome abreviado do nó com oito caracteres com o qual é feito o registro.
- Nome abreviado do servidor - SVN
SVN é o nome abreviado do servidor de destino com oito caracteres.
- Nome do serviço - SVC
SVC é o nome do serviço, com o máximo de 8 caracteres e pode ser mascarado com um * (asterisco). Este parâmetro suporta *, abc*, *abc, abc*xyz, abc*xy*z, etc.
- Mínimo de conexões - MNC
MNC é o mínimo de conexões. O mínimo é 0. Ele será padronizado como 1 se não for fornecido um valor.
- Máximo de conexões - MXC
MXC é o máximo de conexões. O máximo é 99999. Ele é padronizado para 10 se um valor não for fornecido.
- Propagação de segurança - SEC
SEC é a propagação de segurança e é configurado como Y ou N para yes ou no. SEC=N é o padrão. Para SEC=N e chamando do CICS para o WebSphere Application Server, o ID do usuário da região CICS é propagado. Para SEC=N e chamando do WebSphere Application Server para o CICS no Link do servidor (tarefa BBO$), a tarefa do Link é executada com o ID do usuário com o qual o servidor de Link foi iniciado. Para SEC=Y e chamando do CICS para o WebSphere Application Server, o ID do usuário do nível de tarefa é propagado para o WebSphere Application Server. Para SEC=Y e chamando do WebSphere Application Server para o CICS, o servidor de Link tenta iniciar a tarefa do Link (BBO#) com o ID do usuário propagado do WebSphere Application Server. Isso somente funcionará se uma configuração SURROGAT SAF válida tiver sido concluída para permitir que o ID do usuário com o qual o servidor de Link está em execução emita EXEC CICS START TRAN('BBO#') USERID(<propagated_id>).
- TXN
TXN descreve o comportamento transacional do registro gerado pela transação BBOC.
Quando BBOC cria um registro usando a operação REGISTER, TXN=Y significa que os aplicativos Java Platform, Enterprise Edition que foram iniciados no WebSphere Application Server usando esse registro devem associar-se à atual unidade de trabalho do CICS. Isso cria uma transação global entre o CICS e o WebSphere Application Server, que é concluída usando o protocolo two-phase commit quando o aplicativo do CICS emite um EXEC CICS SYNCPOINT ou quando é implicado um ponto de sincronização, como quando a tarefa do CICS é encerrada.
Ao usar BBOC para criar um servidor de link usando a função START_SRVR, TXN=Y significa que a tarefa do servidor de link do CICS deve associar-se à atual transação do WebSphere Application Server quando um serviço for chamado. Por exemplo, se um aplicativo Java Platform, Enterprise Edition iniciar uma transação local de gerenciador de recursos (RMLT) e chamar um programa do CICS usando o conector JCA dos adaptadores locais otimizados, a tarefa de link se associará à transação local e, em seguida, chamará o programa do CICS de destino. As atualizações feitas no programa do CICS não são confirmadas ou restauradas até que o aplicativo Java Platform, Enterprise Edition conclua a RMLT usando a API de confirmação ou retrocesso.
- ID de transação CICS do servidor de Link
- STX
STX é o nome com quatro caracteres do ID de transação CICS do Servidor de Link a ser usado. O valor padrão para o STX é BBO$.
- ID de transação de tarefa de link - LTX
LTX é o nome com quatro caracteres do ID de transação CICS do Programa de Link a ser usado. O padrão para LTX é BBO#. Se esses nomes de transação forem substituídos por nomes fornecidos pelo usuário, eles deverão ser definidos com o mesmo nome do programa e atributos como BBO$ (para STX) e BBO# (para LTX).
- Rastreio - TRCO rastreio é ativado e configurado durante o processamento de qualquer um dos comandos listados na tabela. Há três níveis de rastreio:
- 0 = nenhum e apenas mensagens de erro
- 1 = básico
- 2 = detalhado
- Fila de dados temporários - TDQ
Os dados de rastreio no CICS são gravados no TDQ de partição extra solicitado. O parâmetro TDQ especifica um nome com quatro caracteres do TDQ de partição extra do CICS no qual as mensagens do adaptador devem ser gravadas. se o nome com quatro caracteres não for fornecido, ele será padronizado como BBOQ e DD BBOOUT. Se houver um problema ao gravar no TDQ selecionado, as mensagens serão então gravadas no stdout da região CICS (tdq CESO dd CEEOUT).
- Reusar - REUSe for determinado que o servidor de Link pode executar com SEC=N, o melhor desempenho é obtido ao executar também com o parâmetro REU=Y BBOC START_SRVR. REU=Y resulta no servidor Link reutilizando as tarefas de chamada de Link do programa (transações BBO#) entre pedidos de chamada do programa.Importante: Se você executar o servidor de Link nessa configuração, o suporte no JCA dos adaptadores locais otimizados para a transmissão de um ID de transação LINK separado para solicitações individuais será desativado e uma solicitação para esse resultado será lançada de volta para o aplicativo em uma ResourceException. Além disso, se tentar selecionar REU=Y e SEC=Y, a opção de reutilização é forçada para Não porque o servidor de link deve iniciar uma nova tarefa de Link de Programa para cada solicitação com a identidade que foi propagada e asserida.
- Contagem de reutilizações - REUC Insira o número de solicitações em que a tarefa de Link do CICS (BBO#) permanece ativa e é reutilizada. Ao atingir a contagem, a tarefa de Link é finalizada. O valor máximo é 2147483648.Importante: Para um cenário transacional, a tarefa de Link é finalizada quando a contagem é atingida e a confirmação seguinte é recebida a partir do servidor de aplicativos.
- Tempo de reutilização - REUT Insira o número de segundos em que a tarefa de Link do CICS (BBO#) permanece ativa e é reutilizada. Quando esse intervalo de tempo expira, após o recebimento e processamento da solicitação seguinte, a tarefa de Link é finalizada. O valor máximo é 2147483648.Importante: Para um cenário transacional, a tarefa de Link é finalizada quando o tempo solicitado é atingido e a confirmação seguinte é recebida a partir do servidor de aplicativos.
- Listar nome da fila de Armazenamento Temporário de Servidores de Link - LTSQ
LTSQ se aplica somente à operação LIST_SRVR. LTSQ é o nome de uma fila de armazenamento temporário do CICS em que são gravados a lista de Servidores de Link e informações para cada um deles. Ele pode ser uma sequência de até 8 caracteres de comprimento. Um arquivo de cabeçalho C que mostra o formato dos registros de saída é fornecido em /<install_root>/AppServer/util/zos/OLASamples/bboaapic.h e descrito sob a estrutura tsq_record.
Nome da operação | Abreviatura | Abreviação, Descrição |
Executar Como |
---|---|---|---|
START_TRUE | STR | Inicie a TRUE do WebSphere Application Server | TRC=0/1/2 TDQ=<tdqname> |
STOP_TRUE | PTR | Pare a TRUE do WebSphere Application Server | TRC=0/1/2 TDQ=<tdqname> |
REGISTER | REG | Registrar com o grupo, nó e servidor do daemon dos adaptadores locais otimizados do WebSphere Application Server | RGN=<name> DGN=<name> NDN=<name> SVN=<name> MNC=<minimum_number_ of_connections> MXC=<maximum_number_ of_connections> SEC=<yes|no> TXN=<yes|no> TRC=0|1|2 TDQ=<tdqname> |
UNREGISTER | Cancelar registro nos adaptadores locais otimizados do WebSphere Application Server | RGN=<name> | |
START_SRVR | STA | Inicie a tarefa do WebSphere Application Server para o nome de Registro transmitido. | RGN=<name> DGN=<name> NDN=<name> SVC=<name> SVN=<name> MNC=<minimum_number_ of_connections> MXC=<maximum_number_ of_connections> SEC=<yes|no> STX=<CICS_link_server_ transaction_ID> LTX=<CICS_link_server_ transaction_ID> TRC=0|1|2 TDQ=<tdqname> REU=<yes|no> REUC=<number_of_requests> REUT=<number_of_seconds> |
STOP_SRVR | STP | Pare a tarefa do WebSphere Application Server para o nome de Registro. | RGN=<name> TRC=0/1/2 TDQ=<tdqname> |
LIST_SRVR | LST | Listar todos os Servidores de Link que correspondem ao nome de Registro transmitido. Aqui, os parâmetros são todos opcionais, incluindo o nome de Registro. Quando emitido sem parâmetros, ele retorna uma lista de todos os Servidores de Link. Também é possível transmitir o parâmetro RGN com caracteres curinga. Um asterisco (*) indica que todos os caracteres após esse ponto são válidos e um ponto de interrogação (?) indica que esse único caractere pode ser qualquer caractere. A saída da operação LIST_SRVR é gravada no BBOQ ou na fila de armazenamento temporário denominada no parâmetro TDQ. Se o parâmetro LTSQ for transmitido, a lista de Servidores de Link ativos será gravada na fila de armazenamento temporário do CICS denominada. | RGN=<name> LTSQ=<tsqname> TRC=<0/1/2> TDQ=<tdqname> |
Executando um comando BBOC automaticamente durante a inicialização e o encerramento do CICS
É possível iniciar automaticamente um Servidor de Link de adaptadores locais otimizado ao iniciar o CICS. Isso inicia um BBO$ de tarefa de longa execução até que o Servidor de Link seja parado. Para executar comandos BBOC durante a inicialização do CICS, há dois programas Program List Table Post-Initialization (PLTPI) do CICS fornecidos na biblioteca de carregamento que é criada pelo script copyZOS.sh. Esta biblioteca de carregamento pode ser usada para executar comandos BBOC durante a inicialização do CICS. Inclua BBOACPLT no PLT do CICS como uma entrada da fase 2 ou fase 3, caso deseje ativar a saída do usuário relacionada à tarefa (TRUE) dos adaptadores locais otimizados durante a inicialização do CICS.
INITPARM=(BBOACPL2='STA RGN=PAYROLL DGN=DAE1 NDN=NODE1 SVN=SERVER1 SVC=*')
A cadeia de comandos pode ser qualquer comando BBOC. Se desejar configurar um registro
com o nome WASAPP que consiste em um mínimo de 10 conexões e em um máximo de 100
conexões durante a inicialização do CICS,
especifique o seguinte: INITPARM=(BBOACPL2='REG RGN=WASAPP DGN=DAE1 NDN=NODE1 SVN=SERVER1 MNC=10 MXC=100')
Com isso, não se deve usar a API de Registro nos aplicativos, em vez disso, use as outras APIs imediatamente, por exemplo Chamar, Obtenção de Conexão e Enviar Solicitação e assim por diante.A origem e JCL para os programas PLTPI fornecidos por BBOACPLT e BBOACPL2 são fornecidos em /<install_root>/AppServer/util/zos/OLASamples como arquivos bboacplt.jclsamp e bboacpl2.jclsamp. Há ainda outro programa PLTPI de amostra fornecido. /<install_root>/AppServer/util/zos/OLASamples/bboacpl3.jclsamp fornece um exemplo que mostra como emitir vários comandos BBOC durante a inicialização do CICS.
Há também um JCL de amostra, que mostra como montar o PLT com esses programas incluídos em /<install_root>/AppServer/util/zos/OLASamples/DFHPLTOL.jclsamp.
É necessário cancelar o registro e parar todos os Servidores de Link em execução antes de encerrar o CICS, caso contrário pode ser impossível continuar o encerramento normal. Para cancelar o registro e para um Servidor de Link antes/durante o encerramento do CICS, é possível:
- Executar BBOC STOP_SERVER para todos os servidores de Link do CICS antes do encerramento do CICS
- Incluir o programa Program List Table shutdown (PLTSD) fornecido pela IBM®, BBOACPLS, no PLT de encerramento. Esse PLTSD executa um BBOC LIST_SRVR para identificar todos os Servidores de Link que estão em execução na região e, em seguida, emite uma operação STOP_SRVR para cada um deles. Um JCL de amostra, que mostra como incluir isso em sua lista de encerramento do PLT, é fornecido em /<install_root>/AppServer/util/zos/OLASamples/DFHPLTO2.jclsamp
- Limpe as tarefas BBO$
- Grave seu próprio programa de encerramento do PLT que executa EXEC CICS LINKs em BBOACNTL para cada Servidor de Link, transmitindo a sequência STOP_SERVER
- Emita CEMT P SHUT,IMMED
Executando um comando BBOC a partir de um programa usando EXEC CICS LINK PROGRAM('BBOACNTL')
É possível conduzir operações BBOC a partir de seus programas usando EXEC CICS LINK PROGRAM('BBOACNTL') e passando a sequência de caracteres de comando no COMMAREA. Se o comprimento da sequência de caracteres de comando no COMMAREA transmitido for menor que 268 caracteres, você receberá em retorno uma sequência que contém apenas o resultado da execução do comando. Se o comprimento for igual ou maior que 268 caracteres, BBOC/BBOACNTL fornecerá uma versão de número inteiro, um código de retorno de número inteiro e um código de razão de número inteiro nos bytes de 256 - 268. Aqui está a estrutura da área retornada da Versão 1:
/* Version 1 DFHCOMMAREA - for EXEC CICS LINK to BBOACNTL */
struct inputCommarea {
char command[256];
};
struct outputCommarea_v1 {
char message[256];
int version;
int returnCode;
int reasonCode;
};
struct BBOACNTL_Commarea {
union {
struct inputCommarea input;
struct outputCommarea_v1 output;
};
};
Quando um COMMAREA maior ou igual a 268 bytes é transmitido como entrada para BBOACNTL, ele obtém de volta uma resposta de mensagem nos primeiros 256 bytes, seguida pela área mostrada anteriormente com a Versão, o Código de Retorno e o Código de Razão da operação executada por BBOC/BBOACNTL. A seguir são mostrados os códigos de retorno e de razão suportados do EXEC CICS LINK para BBOACNTL:
RC 0 RSN 0
Request process successfully. The response message in the first 256 bytes provides more information. Search the Information Center with the returned message id for further information about the response.
RC 4 RSN 0
No Link Servers match the requested registration name or no Link Servers are running in this region. The response message in the first 256 bytes provides more information. Search the Information Center with the returned message id for further information about the response.
RC 8 RSN 0 or higher
An error occurred in processing the request. The response message in the first 256 bytes provides more information. Search the Information Center with the returned message id for further information about the response.
RC 12 RSN 0 or higher
An severe error occurred in processing the request. The response message in the first 256 bytes provides more information. Search the Information Center with the returned message id for further information about the response.
Passar o parâmetro LTSQ na sequência de caracteres de comando da chamada EXEC CICS LINK para BBOACNTL grava uma lista de Servidores de link ativos correspondentes na fila de armazenamento temporário do CICS passada no parâmetro LTSQ. O formato do registro de saída para cada Servidor de Link na lista é documentado no cabeçalho que está em: /<install_root>/AppServer/util/zos/OLASamples/bboaapic.h e descrito na estrutura tsq_record.
Tarefa do servidor de LINK do WebSphere Application Server para CICS, BB0$
A transação CICS, BBO$, é usada para suporte à chamada de saída do WebSphere Application Server para CICS. Ele é executado em segundo plano como uma transação não terminal e representa uma instância de uma tarefa de servidor que é iniciada usando a operação BBOC START_SRVR para um nome de registro e nome de serviço especificados pelo usuário. Esta tarefa de servidor fornece um recurso de chamada de LINK do programa, ou a capacidade de iniciar um programa CICS existente a partir do WebSphere Application Server por meio das APIs de adaptadores locais otimizados. O nome desta transação pode ser substituído por um nome fornecido pelo usuário, que pode ser fornecido no comando BBOC START_SRVR (STX=xxxx). Se isto for feito, o nome da transação fornecido deverá ser definido para o CICS com o mesmo nome de programa e atributos que BBO$.
Tarefa de Chamada de LINK do Programa do WebSphere Application Server para CICS, BBO#
A transação CICS, BBO#, é usada para suporte à chamada de saída do WebSphere Application Server para CICS. É uma transação não terminal que representa uma instância de uma tarefa que foi iniciada pela tarefa de servidor de adaptadores do WebSphere Application Server, BBO$, para fazer uma chamada de LINK do programa. A transação BBO$ inicia uma transação BBO# para cada pedido de link do programa do CICS a partir de um aplicativo implementado no WebSphere Application Server.
O nome desta transação pode ser substituído por um nome fornecido pelo usuário, que pode ser fornecido no comando BBOC START_SRVR, por exemplo, LTX=xxxx). Se isto for feito, o nome da transação fornecido deverá ser definido para o CICS com o mesmo nome de programa e atributos que a transação BBO#. Como alternativa, o nome com 4 caracteres da transação de link pode ser transmitido do WebSphere Application Server pelo aplicativo que está usando JCA. Neste cenário, o aplicativo que está usando o adaptador está usando o método setLinkTaskTransid.
Asserindo a Identidade do Usuário do WebSphere Application Server para o CICS
Essa tarefa do servidor suporta a propagação da identidade do usuário a partir de uma chamada WebSphere Application Server no CICS e da asserção dessa identidade. A asserção somente será feita se a tarefa Registrar tiver sido executada com o parâmetro de segurança configurado como SEC=Y. Isso é implementado usando um EXEC CICS START TRANSACTION(‘BBO#') USERID(<user_id>).
Uma definição de classe SAF SURROGAT deve ser definida para assegurar que o ID do usuário com o qual a transação BBO$ está sendo executada tenha a autoridade para iniciar uma transação em nome do ID do usuário transmitido.
Se você executar BBOC STRT_SRVR com SEC=N, o ID do usuário associado a pedidos de entrada para o CICS será o ID do usuário que executou a transação BBOC.
Chamadas BBOC de Amostra
- Iniciar o programa TRUE do CICS de adaptadores.
bboc start_true
- Parar o programa TRUE do CICS de adaptadores.
bboc stop_true
- Registrar com o nome CICS-HR1 no grupo de daemons SY1 com o nó
SY1 e com o servidor BBOS001, com o mínimo de 5 e com o máximo de 10
conexões. Configure o transacional para no e a
propagação de segurança para yes.
bboc register rgn=CICS-HR1 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 txn=n sec=y
- Cancelar o registro com o nome CICS-HR1
bboc unregister rgn=CICS-HR1
- Iniciar uma transação do servidor como BBO$ para todos os nomes de serviços e de programas
com o nome de registro, CICSPAYR, com um grupo de daemon, nó e
servidor com um máximo de 10 conexões e um mínimo de 5 conexões.
Configurar o transacional como no e a propagação de segurança como yes.
bboc start_srvr rgn=CICSPAYR svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y
- Parar a transação do servidor BBO$ em execução no nome do registro
CICSPAYR.
bboc stop_srvr rgn=CICSPAYR
- Iniciar uma transação do servidor como BBO$ para os nomes de serviço
e de programa que começam com PAYR no nome de registro CICSPAY1 com um grupo, nó e servidor daemon
com mínimo de 5 e com o máximo de 10 conexões. A transação é no e a propagação de segurança é
yes.
bboc start_srvr rgn=CICSPAY1 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y svc=PAYR*
- Iniciar uma transação do servidor no ID da transação PAY2 e registrar com o nome
PAYROLL2 para todos os nomes de serviço e de programa em um grupo, nó e servidor daemon
com mínimo de 5 e com o máximo de 10 conexões. O valor do parâmetro transacional é yes,
o valor de propagação de segurança é yes e o rastreio está configurado para o nível
1.
bboc start_srvr rgn=PAYROLL2 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y stx=PAY2 trc=1
- Iniciar uma transação do servidor com o ID da transação PAY3 e com o ID
de transação de link PY3L. Registre com o nome, PAYROLL3,
para os nomes de programa e serviço que começam com PAYRL3 em um grupo, nó e servidor de daemon
com mínimo de 5 e o máximo de 10 conexões.
O valor do parâmetro transacional é yes e
o valor do parâmetro de propagação de segurança é yes com rastreio configurado para o nível
1.
bboc start_srvr rgn=PAYROLL3 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y svc=PAYRL3* stx=PAY3 ltx=PY3L trc=1
- Listar todos os Servidores de Link em execução nessa região do CICS
bboc list_srvr
- Listar todos os Servidores de Link em execução nessa região do CICS com um nome de Registro de CICSPAY1
bboc list_srvr rgn=CICSPAY1
- Listar todos os Servidores de Link em execução nessa região do CICS iniciados com um nome de Registro CICS e que copiam a lista para uma Fila de Armazenamento Temporário chamada MYSRVRS
bboc list_srvr rgn=CICS* ltsq=MYSRVRS
- Listar todos os Servidores de Link em execução nessa região do CICS iniciados com um nome de Registro que começa com 'CICS' e, em seguida, todos os caracteres seguidos por 'ZZZ' e quaisquer outros caracteres depois desse
bboc list_srvr rgn=CICS?ZZZ*
Suporte para canais e objetos contêineres do CICS
Para mensagens maiores que 32 K, os programas de aplicativo CICS que são iniciados a partir do WebSphere Application Server precisam receber dados e enviar dados de respostas usando os canais e contêineresCICS. Os aplicativos implementados no WebSphere Application Server podem usar a interface de programação JCA fornecida para fornecer o nome e tipo (BIT|CHAR) do contêiner do CICS, que transmite os dados para o programa de destino e o nome e tipo de contêiner que recebe a resposta do aplicativo.
- Ao passar um único contêiner e receber um único contêiner, os métodos setLinkTaskReqContid, setLinkTaskRspContid, setLinkTaskReqContType(bit|char) e setLinkTaskRspContType(bit|char) podem ser usados. Para ambos a solicitação e a resposta, o nome de canal, IBM-WAS-ADAPTER, é usado. Esse nome de canal é fixo.
- Como alternativa, a interface MappedRecord do JCA pode ser usada para enviar e receber um ou mais contêineres de um programa do CICS de destino. Ao usar o MappedRecord, use os métodos setLinkTaskChanID()
e setLinkTaskChanType() do ConnectionSpecImpl para configurar o nome do canal que será usado para reter os contêineres de solicitação e de resposta, assim como o tipo de contêineres (bit ou car) que serão contidos no canal.
Os nomes de contêineres de solicitações individuais são configurados incluindo dados no MappedRecord, usando o método put().
As chaves do MappedRecord correspondem aos nomes de contêiner do CICS e os valores correspondentes são usados para preencher o contêiner no CICS. A chave deve ser um objeto String com um comprimento entre 1-16 caracteres. O valor pode ser um byte[] ou um objeto RecordBytes gerado por um conjunto de ferramentas, como o Rational Application Developer.
Os nomes do contêiner de resposta são extraídos do canal após a conclusão da solicitação do CICS e preenchidos em um novo MappedRecord, que é retornado para o cliente.