Use esta tarefa quando usar as APIs de saída para conectar-se com um aplicativo
em um espaço de endereço externo a partir do aplicativo que é implementado no
WebSphere Application Server for z/OS.
Antes de Iniciar
O grupo de daemon, o espaço de endereço e o espaço de endereço externo
devem ser configurados para usar as APIs de adaptadores locais otimizadas. O espaço de endereço
externo deve ser registrado no grupo de daemon, chamando a API BBOA1REG.
O aplicativo que está
em execução no espaço de endereço externo deve ter se estabelecido como uma tarefa de servidor de
adaptadores locais otimizados usando uma das APIs, incluindo
BBOA1SRV, BBOA1RCA ou BBOA1RCS.
O arquivo
Resource Adapter Archive (RAR) dos adaptadores locais otimizados, ola.rar,
é implementado e configurado usando o console administrativo do
WebSphere Application Server ou o script
olaRar.py.
Procedimento
- Localize o descritor de implementação do aplicativo no aplicativo que
faz a chamada externa. Este é o aplicativo que é implementado no
WebSphere Application Server
do qual deseja fazer uma chamada de saída.
- Crie uma referência de recurso que aponte para o Connection Factory do adaptador local otimizado. O connection factory do adaptador local otimizado é criado quando o arquivo ola.rar
é instalado no WebSphere Application Server.
- Localize o connection factory para o adaptador local otimizado. É possível localizar o connection factory, consultando a referência de recurso no Java™ Naming Directory Interface (JNDI), por exemplo:
Context ctx = new InitialContext();
ConnectionFactory cf = ctx.lookup("java:comp/env/ola");
- Crie uma chamada de método ConnectionSpecImpl e forneça o nome de registro ao qual se conectar. É possível usar o nome de Registro
como um atributo na connection
factory gerenciada ou usar o método ConnectionSpecImpl, setRegisterName, para fornecer
o nome de registro para o aplicativo que está em execução
no espaço de endereço externo ou subsistema ao qual você deseja conectar-se. Deve ser o mesmo nome de registro fornecido pelo aplicativo no espaço de endereço externo ou
subsistema usando uma das APIs dos adaptadores locais otimizados do servidor,
BBOA1SRV, BBOA1RCA ou BBOA1RCS. Por exemplo,
ConnectionSpecImpl csi = new ConnectionSpecImpl();
csi.setRegisterName ("MyRES1");
Atenção: Não será necessário configurar o nome de registro
no objeto ConnectionSpecImpl se o nome de registro foi especificado
usando a propriedade customizada RegisterName
no objeto ConnectionFactory.
Atenção: Se desejar usar o recurso de alta disponibilidade
do adaptador de recursos, deverá assegurar-se de que seu aplicativo não use
o método setRegisterName e, em vez disso, deverá configurar o nome de Registro
de destino nos atributos do connection connection factory de conexão gerenciados. Consulte o tópico, Ativando Suporte de Alta Disponibilidade do Adaptador de Recursos,
para obter mais informações sobre como configurar a alta disponibilidade.
- Opcional: Se estiver chamando uma transação do Information
Management System (IMS) que não usa as APIs
de servidor do adaptador local otimizado, BBOA1SRV, BBOA1RCA ou BBOA1RCS, use essa etapa para configurar os parâmetros IMS Open Transaction Manager Access (OTMA). É possível configurar o nome do servidor IMS OTMA, o ID do grupo XCF
e o nível de transação como atributos no connection factory gerenciado,
ou usar os métodos setter ConnectionSpecImpl, setOTMAServerName,
setOTMAGroupID e setOTMATranLevel correspondentes para fornecer essas
informações para o aplicativo que está executando no espaço de endereço
ou subsistema externo ao qual deseja conectar-se.
Atenção: Quando usar os adaptadores locais otimizados sobre o OTMA,
o nome do registro não possuirá um correspondente no lado da transação do IMS. O nome do registro pode ser configurado, mas não é usado para as chamadas do adaptador local otimizado sobre o OTMA. Para obter mais informações, consulte o tópico Chamando Transações IMS Existentes com
Adaptadores Locais Otimizados sobre OTMA.
- Use o connection factory para criar uma conexão, por exemplo:
Connection con = cf.getConnection(csi);
Resultados
Seu aplicativo que está implementado no
WebSphere Application Server é conectado a um espaço de endereço externo e pronto para chamar os serviços que são hospedados
no espaço de endereço externo.