[z/OS]

Usando Adaptadores Locais Otimizados para Conectar-se a um Aplicativo em um Espaço de Endereço Externo de um Aplicativo WebSphere

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

  1. 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.
  2. 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.
  3. 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");
  4. 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.
  5. 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.
  6. 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.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_connect2wasapp
Nome do arquivo: tdat_connect2wasapp.html