[z/OS]

Utilización de adaptadores locales optimizados para conectarse a una aplicación en un espacio de direcciones externo desde una aplicación WebSphere.

Utilice esta tarea para usar las API de salida para conectar a una aplicación en un espacio de direcciones externo desde una aplicación que se despliega en WebSphere Application Server para z/OS.

Antes de empezar

El grupo de daemons, el espacio de direcciones y el espacio de direcciones externo deben configurarse para utilizar las API de adaptadores locales optimizados. El espacio de direcciones externo debe registrarse en el grupo de daemons mediante la llamada de la API BBOA1REG.

La aplicación que se está ejecutando en el espacio de direcciones externo debe haberse establecido como una tarea de servidor de adaptadores locales optimizados que utilice una de las API, BBOA1SRV, BBOA1RCA o BBOA1RCS.

El archivo de adaptador de recursos (RAR) de los adaptadores locales optimizados, ola.rar, se despliega y se configura mediante la consola administrativa de WebSphere Application Server o el script olaRar.py.

Procedimiento

  1. Localizar el descriptor de despliegue de la aplicación que realiza la llamada externa. Ésta es la aplicación que se ha desplegado en WebSphere Application Server desde la cual desea realizar una llamada de salida.
  2. Cree una referencia de recursos que señale a la fábrica de conexiones del adaptador local optimizado. La fábrica de conexiones del adaptador local optimizado se crea cuando se instala el archivo ola.rar en WebSphere Application Server.
  3. Busque la fábrica de conexiones del adaptador local optimizado. Para buscar la fábrica de conexiones, busque la referencia de recursos en la interfaz JNDI (Java™ Naming Directory Interface), por ejemplo:
    Context ctx = new InitialContext();
    ConnectionFactory cf = ctx.lookup("java:comp/env/ola");
  4. Cree una llamada de método ConnectionSpecImpl y proporcione el nombre de registro al que conectarse. Puede utilizar el nombre de registro como un atributo en la fábrica de conexiones gestionadas o utilizar el método ConnectionSpecImpl, setRegisterName, para proporcionar el nombre de registro para la aplicación que se ejecuta en el espacio de direcciones externo o el subsistema al que se desea conectar. Debe ser el mismo nombre de registro que el que proporcionó la aplicación en el espacio de direcciones externo o subsistema mediante una de las API de adaptadores locales optimizados de servidor, BBOA1SRV, BBOA1RCA o BBOA1RCS. Por
    ConnectionSpecImpl csi = new ConnectionSpecImpl();
    csi.setRegisterName ("MyRES1");
    Atención: Definir el nombre de registro en el objeto ConnectionSpecImpl no es necesario si el nombre de registro se ha especificado mediante la propiedad personalizada RegisterName en el objeto ConnectionFactory.
    Atención: Si desea utilizar la característica de alta disponibilidad del adaptador de recursos, debe asegurarse de que la aplicación no utiliza el método setRegisterName y en su lugar debe configurar el nombre de Registro de destino en los atributos de la fábrica de conexiones de la conexión gestionada. Consulte el tema 'Habilitar el soporte de alta disponibilidad del adaptador de recursos' para obtener más información sobre cómo configurar la alta disponibilidad.
  5. Opcional: Si llama a una transacción IMS (sistema de gestión de información) que no utiliza las API de servidor de adaptador local optimizado, BBOA1SRV, BBOA1RCA o BBOA1RCS, utilice este paso para establecer los parámetros IMS OTMA (Open Transaction Manager Access). Puede establecer el nombre de servidor IMS OTMA, el ID de grupo XCF y el nivel de transacción como atributos en la fábrica de conexiones gestionadas, o utilizar los métodos de establecimiento de ConnectionSpecImpl correspondientes, setOTMAServerName, setOTMAGroupID y setOTMATranLevel, para proporcionar esta información para la aplicación que se ejecuta en el espacio de direcciones externo o subsistema al que desea conectarse.
    Atención: Cuando se utilizan adaptadores locales optimizados a través de OTMA, el nombre de registro no tiene un equivalente en el lado de las transacciones IMS. El nombre de registro se puede establecer, pero no se utiliza para llamadas de adaptadores locales optimizados sobre OTMA. Para obtener más información, consulte el tema Invocación de las transacciones IMS existentes con adaptadores locales optimizados a través de OTMA.
  6. Utilice la fábrica de conexiones para crear una conexión, por ejemplo:
    Connection con = cf.getConnection(csi);

Resultados

La aplicación desplegada en WebSphere Application Server se conecta a un espacio de direcciones externo y está lista para realizar llamadas a los servicios albergados en el espacio de direcciones externo.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_connect2wasapp
File name: tdat_connect2wasapp.html