Para adaptadores locais otimizados fazer uma chamada de saída para seu
grupo de daemon local ou uma chamada recebida para uma célula doWebSphere Application Server, você deverá ligar o espaço de endereço atual ao grupo de daemon do WebSphere Application Server e estabelecer
atributos de conexão.
Antes de Iniciar
O grupo de daemon do
WebSphere Application Server
deve estar ativo na mesma imagem do z/OS a partir da qual
a solicitação de registro é originada. Se você estiver usando o Customer
Information Control System (CICS),
o programa Task-Related User Exit (TRUE) deverá ser ativado antes que uma conexão
seja feita entre o CICS e o
WebSphere Application Server.
Se você estiver usando o
Information Management System (IMS), a interface do subsistema externo do adaptador local otimizado deve ser instalada e ativada antes que os aplicativos comecem a
chamar as APIs do adaptador local otimizado.
Procedimento
- Defina os parâmetros para uso na conexão. Quando você estiver usando o
CICS, o sinalizador reg_flag_trans
será configurado para 1 para indicar que as conexões criadas nesse
nome do registro devem ser ligadas ao RRS e unidas ao trabalho feito em uma
transação global do WebSphere Application Server. Configurar esse sinalizador para 0 (zero) indica
que não há nenhuma conexão criada nesse nome do registro que deve ser conectado
ao RSS e unido ao trabalho feito em uma transação global do WebSphere Application Server.
Para as chamadas recebidas, um contexto de segurança é sempre
propagado para o WebSphere Application Server
e contém o ID do usuário do espaço de endereço que faz a solicitação. Para o CICS, o sinalizador reg_flag_C2Wprop
propaga o ID do usuário que a tarefa do CICS está
usando atualmente, em vez do ID do usuário a partir do espaço de endereço.
Para as chamadas de saída, o sinalizador
reg_flag_W2Cprop informa ao WebSphere Application Server para propagar o ID do
usuário para o CICS. O CICS então tenta iniciar o programa de destino com esse ID do usuário.
Para ler mais sobre o uso da segurança, consulte os tópicos, Protegendo Adaptadores Locais
Otimizados para Suporte de Entrada e Protegendo Adaptadores Locais Otimizados
para Suporte de Saída.
- Verifique se o nome do registro já não é usado em outra célula à qual este espaço de
endereço está conectado. Uma verificação de espaço de endereço é feita para assegurar
que o nome de registro já não esteja em uso por outra célula. Se o nome do registro for usado por
outra célula, será passado um código de retorno de erro e o pedido de registro falhará.
- Configure o aplicativo de idioma nativo de espaço de endereço do cliente para chamar
a API BBOA1REG. O grupo do daemon e o nome do servidor são passados e uma sequência de
entrada que representa o nome, ou o nome do registro que é usado pelo daemon do
WebSphere Application Server.
Um código de retorno e de razão 0 (zero) indica que o espaço de endereço do cliente agora está
limitado ao grupo de daemon do WebSphere Application Server
e ao servidor selecionado. As chamadas futuras que interagem com esse
WebSphere Application Server devem ter ou um
nome de registro fornecido ou um identificador de conexão específico que foi
criado usando esse nome de registro que as acompanha.
Resultados
Depois de concluir esta tarefa, a cadeia de nome de registro passada
é reservada no espaço de endereço atual. Nenhuma outra chamada de registro pode ser feita com este
token até que uma chamada de cancelamento de registro seja recebida para ela.
Importante: Se você usar
a configuração mínima de conexões nesta chamada, o resultado será um conjunto de conexões que são
pré-estabelecidas com o servidor de destino e aguardando por pedidos.
Além disso, um
contexto de entrada de registro ou bloco de controle é criado e associado à cadeia de nome de registro. Cada nome de registro exclusivo possui um contexto de registro.
Vários nomes de registro com o mesmo espaço de endereço e encadeamento podem
ser ligados a um ou mais grupos de daemon do
WebSphere Application Server.
O que Fazer Depois
Para ler mais sobre a API BBOA1REG, consulte o tópico Adaptadores Locais
Otimizados para APIs Nativas do z/OS.