Para que los adaptadores locales optimizados de WebSphere (WOLA) realicen una llamada de salida a su grupo local de adaptadores locales optimizados o una llamada de entrada a un servidor de Liberty, debe enlazar el espacio de direcciones actual con el servidor de
Liberty y establecer atributos de conexiones utilizando la API Register.
Procedimiento
- Decida qué parámetros va a utilizar cuando registre el espacio de direcciones utilizando la API Register, BBOA1REG.
La API acepta parámetros para los elementos siguientes:
- Las tres partes del nombre de grupo de WOLA que ha especificado cuando ha añadido la característica en el archivo server.xml
- El nombre de registro
- El número mínimo de conexiones iniciales
- El número máximo de conexiones
- Las palabras del distintivo de registro para especificar el comportamiento de rastreo
Para llamadas de entrada al servidor de Liberty, siempre se propaga al servidor de Liberty un contexto de seguridad que contiene el ID de usuario del espacio de direcciones que realiza la solicitud. Para CICS, el distintivo de registro reg_flag_C2Wprop propaga el ID de usuario de la tarea de CICS en lugar del ID de usuario desde el espacio de direcciones.
Para llamadas de salida desde el servidor de Liberty, el distintivo de registro reg_flag_W2Cprop indica al servidor de
Liberty que propague el ID de usuario en CICS. CICS intenta iniciar el programa de destino con dicho ID de usuario.
Para obtener más información sobre los parámetros de la API, consulte
API de adaptadores locales optimizados en Liberty for z/OS y Seguridad de los adaptadores locales optimizados en Liberty for z/OS.
- Verifique que otro grupo de adaptadores locales optimizados al que está conectado este espacio de direcciones todavía no está utilizando el nombre de registro seleccionado. Si el nombre de registro lo utiliza otro grupo de adaptadores locales optimizado, se pasará un código de retorno de error y fallará la solicitud de registro.
- Invoque la API Register para su interlocutor desde la aplicación de lenguaje nativo en el espacio de direcciones cliente utilizando los parámetros que ha seleccionado.
Un código de retorno y un código de razón de 0 indican que el espacio de direcciones cliente está enlazado ahora al servidor de
Liberty.
Resultados
La serie de nombre registrado que se ha pasado se reserva en el espacio de direcciones actual. No se pueden hacer otras llamadas de registro con esta señal hasta que se reciba una llamada a la API Unregister con esta finalidad.
Importante: Si utiliza el valor mínimo de conexiones en esta llamada, el resultado será una agrupación de conexiones que se han establecido previamente con el servidor de destino y se esperarán solicitudes.
También se crea un contexto de entrada de registro o un bloque de control y se asocia a la serie del nombre de registro. Cada nombre de
registro exclusivo tiene un contexto de registro. Es posible enlazar varios nombres de registro con el mismo espacio de direcciones y la misma hebra con un grupo de adaptadores locales optimizados de
Liberty o más de uno.
Qué hacer a continuación
Puede utilizar el registro para realizar llamadas de entrada y de salida entre el entorno de
Liberty y el espacio de direcciones externo. Para obtener más información, consulte
Desarrollo de aplicaciones que utilizan adaptadores locales optimizados en Liberty.