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
- 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.
- 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.
- 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");
- 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.
- 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.
- 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.