Os adaptadores locais otimizados para o arquivo resource archive (RAR) do z/OS deve ser instalado
no nó local. Ao executar em uma plataforma não z/OS, o arquivo RAR
dos adaptadores locais otimizados se comunica com uma instância do arquivo
enterprise archive (EAR) do proxy de adaptadores locais otimizados em um nó do z/OS remoto usando Remote Method Invocation
over Internet Inter-ORB Protocol (RMI-IIOP).
Antes de Iniciar
Para obter mais informações sobre adaptadores locais otimizados no modo
de desenvolvimento, leia o tópico Implementação dos Adaptador Locais Otimizados
no Modo de Desenvolvimento.
Sobre Esta Tarefa
Ao criar uma connection factory de adaptadores locais otimizados
no nó local, várias propriedades devem ser configuradas para permitir que a comunicação
ocorra:
- RemoteHostname
- O nome do host do nó z/OS remoto
- RemotePort
- A porta RMI no nó z/OS remoto.
Ela pode ser a porta RMI para uma instância do WebSphere Application Server para z/OS específica ou o agente do nó.
- RemoteJNDIName
- O nome de Java™ Naming and Directory
Interface (JNDI) no qual o EAR do proxy de adaptadores locais otimizados
foi ligado no JNDI no nó remoto. A consulta do JNDI é executada
usando um JNDI InitialContext, o qual é obtido usando as propriedades
RemoteHostname e RemotePort especificadas e solicitando o namespace
NameSpaceServerRoot.
- RemoteJNDIUsername
- O nome de usuário a ser usado ao obter o contexto de nomenclatura de JNDI
do nó remoto
- RemoteJNDIPassword
- A senha a ser usada ao obter o contexto de nomenclatura de JNDI
do nó remoto.
- RemoteJNDIRealm
- O nome da região a ser usado ao obter o contexto de nomenclatura de JNDI
do nó remoto. Especificar o nome da região pode ser necessário quando
os nós local e remoto usam a segurança do WebSphere mas estão em
domínios diferentes.
Procedimento
- O arquivo RAR dos adaptadores locais otimizados no nó local
obtém uma referência para o EAR de proxy de adaptadores locais otimizados executando
uma consulta do JNDI. Um contexto de nomenclatura é obtido usando uma URL igual a corbaloc:iiop:<RemoteHostname>:<RemotePort>/NameSpaceServerRoot.
Quando este contexto for obtido, uma consulta será executada usando RemoteJNDIName. Assumindo que o EAR do proxy de adaptadores locais otimizados foi instalado
em um nó do z/OS remoto usando
o local de ligação de JNDI padrão, o RAR de adaptadores locais otimizados
no nó local pode ser instalado especificando a porta RMI da instância do
WebSphere Application
Server para z/OS de destino e
um RemoteJNDIName igual a com.ibm.ws390.ola.jca.ProxyEJBRemote, que
é a ligação padrão para a interface remota de proxy dos adaptadores locais
otimizados.
- Outras propriedades das conexão fábrica RAR de adaptadores locais
otimizados no nó local, tal como registerName, podem ser configuradas especificando-as
nos atributos de connection factory para o adaptador de recursos.
Estes valores são honrados no nós do z/OS remoto.
- O nó local e o nó do z/OS remoto não podem compartilhar o mesmo registro do usuário.
Duas propriedades adicionais estão disponíveis na connection factory
RAR de adaptadores locais otimizados para fornecer à solicitação uma oportunidade
de efetuar logon e especificar o ID do usuário para uso para a interação de adaptadores
locais otimizados:
- Nome do usuário
- O nome de usuário a ser usado ao executar a interação de adaptadores locais
otimizados
- Senha
- A senha a ser usada com a propriedade Nome de Usuário
Ao especificar Nome de Usuário e Senha, ocorre um logon
logo antes de a interação de adaptadores locais otimizados ser executada. Se o logon for bem-sucedido, o ID do usuário do z/OS correspondente ao
Nome de Usuário será enviado com a solicitação de adaptadores locais otimizados.
Atualmente,
o ID do usuário do z/OS é usado ao se
comunicar com o CICS usando o servidor
de link de adaptadores locais otimizados. A transação do CICS de destino será iniciada usando o ID do usuário do z/OS se o servidor de link for iniciado com o parâmetro SEC=YES e a região do CICS estiver em execução com SEC=YES.
Para o IMS, esse ID de usuário será propagado
e declarado somente quando a opção SYNC-TO-THREAD for ativada no servidor
WebSphere Application Server for z/OS e o parâmetro OTMASE=FULL OTMA
estiver em vigor.
Um alias do
JAAS do J2C também pode ser usado para fornecer os valores de Nome de Usuário e
Senha. Para usar um alias do JAAS do J2C, no console administrativo, clique em Recursos
> Adaptadores de Recursos > Connection factories do J2C > cf_name >
Dados de autenticação do J2C do JAAS > alias_name e
insira o ID do usuário e a senha. O adaptador de recursos recupera o ID do usuário
e a senha desta configuração. Se também for fornecido um alias do JAAS,
bem como o Nome de Usuário e a Senha no connection factory,
o Nome de Usuário e a Senha no connection factory terá prioridade.
Os métodos setUserid() e setPassword() no ConnectionSpecImpl
tem prioridade sobre ambos desses outros métodos.