[z/OS]

Solicitud de trabajo remoto de WebSphere Optimized Local Adapter (WOLA) en un destino Enterprise Java Bean

Esta función permite que una aplicación cliente como, por ejemplo, un proceso por lotes, CICS, etc. se ponga en contacto con una instancia del servidor remoto WebSphere Application Server que aloja una aplicación cuya ejecución de la lógica empresarial y los resultados los necesita el cliente. La invocación remota se lleva a cabo aprovechando las API BBOA1INV/BBGA1INV y BBOA1SRQ/BBGA1SRQ y una aplicación proxy (RemoteEJBProxy), que se suministra junto con WebSphere Application Server para z/OS.

Antes de instalar esta característica, revise los requisitos y los parámetros de configuración:
  1. Federe el espacio del nombre de la instancia del servidor WebSphere Application remoto en el z/OS WebSphere Application Server local para permitir al servidor local buscar la aplicación en el servidor remoto. La aplicación remota debe ser un Enterprise Java™ Bean sin estado que implemente un método denominado execute(), que acepta una matriz de bytes como entrada y devuelve una matriz de bytes como salida, tal como lo define la interfaz com.ibm.websphere.ola.Execute. También debe especificar el nombre com.ibm.websphere.ola.ExecuteHome para la interfaz inicial EJB y com.ibm.websphere.ola.Execute para la interfaz remota cuando se utiliza la especificación EJB 2.1 o especificaciones anteriores, o debe definir la anotación @RemoteHome especificando com.ibm.websphere.ola.ExecuteHome cuando se utiliza la especificación EJB 3.0. Estas interfaces están disponibles en el tiempo de ejecución tanto en WebSphere Application Server para z/OS como en WebSphere Application Server para plataformas distribuidas. Para fines de desarrollo de aplicaciones remotas, las mencionadas interfaces se suministran junto con WebSphere Application Server para z/OS como parte de la herramienta de ensamblaje ola_apis.jar. No empaquete estas interfaces con el archivo EAR de la aplicación.
  2. Instale el archivo EAR del proxy de adaptadores locales optimizados (ola_proxy.ear) que contiene la aplicación RemoteEJBProxy en la instancia del servidor z/OS WebSphere Application Server local. El archivo EAR se puede encontrar en el directorio $(WAS_INSTALL_ROOT)/installableApps del sistema de archivos WebSphere Application Server para z/OS.

    La aplicación remoteEJBProxy se enlaza de forma predeterminada al nombre JNDI: ejb/com/ibm/ws390/ola/jca/RemoteEJBProxyHome. Si por cualquier motivo el valor predeterminado tuviera que cambiarse, el nombre JNDI del recurso de destino de la aplicación proxy se podría personalizar a través de la página de la consola administrativa bajo Aplicaciones > ola_proxy > Nombre JNDI de EJB > Nombre JNDI para todas las interfaces. Si se actualiza el nombre JNDI, debe notificar el cambio al tiempo de ejecución de WebSphere estableciendo la variable de entorno ola_remote_ejb_proxy_jndiname tal como se describe en el tema acerca de las variables de entorno de los adaptadores locales optimizados.

    Fíjese que dispone del paso opcional de cambiar el nombre JNDI predeterminado de la aplicación remoteEJBProxy. Si no necesario a menos que tenga que cambiarlo.

  3. Reinicie los servidores.

El procedimiento de invocación para las API de invocación (BBOA1INV/BBGA1INV) y de solicitud de envío (BBOA1SRQ/BBGA1SRQ) es el mismo que el de las invocaciones locales, con la única diferencia que el parámetro de tipo solicitud de invocación (requesttype) debe establecerse en 2 tal como se describía en los adaptadores locales optimizados para el tema acerca de las API de z/OS.

El nombre de servicio (nombre JNDI) especificado en las llamadas de la API de solicitud de invocación o envío debe ser el nombre que el programa local WebSphere Application Server para z/OS utilizaría para buscar la aplicación remota mediante el espacio de nombres JNDI federado para el servidor remoto. Por ejemplo, si se ha federado el espacio de nombres del servidor remoto en la ubicación remote/server5, y la aplicación se ha instalado utilizando el nombre JNDI ejb/myRemoteApp en el servidor remoto, el nombre de servicio especificado en la API de invocación o la API de solicitud de envío sería remote/server5/ejb/myRemoteApp.

Esta característica también proporciona la posibilidad de invocar la aplicación remota dentro de una transacción global iniciada por un cliente. Cuando se utiliza un cliente de CICS dentro de una transacción global, el salida puede dar como resultado una terminación anómala ASP3 cuando CICS detecta que la transacción se ha retrotraído después de emitir un mandato para confirmar la transacción global. Se trata de un caso esperado cuando se da el manejo de CICS en un caso de ejemplo de este tipo. El comportamiento de retrotracción es también un comportamiento esperado en casos en los que se produce una condición de error mientras se procesa la invocación de EJB como, por ejemplo, que la salida de la transacción global no puede ser otra que la retrotracción.


Icon that indicates the type of topic Reference topic



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