Para que los adaptadores locales optimizados realicen una llamada de salida a un grupo de daemon
local o una llamada de entrada a una célula WebSphere Application Server, debe enlazar
el espacio de direcciones actual con el grupo de daemon WebSphere Application Server y establecer los atributos de conexión.
Antes de empezar
El grupo de daemons de
WebSphere Application Server debe estar activo en
la misma imagen de z/OS de la que se origina la solicitud de registro. Si utiliza el sistema de control de información de cliente (CICS),
el programa TRUE (salida de usuario relacionada con la tarea) se debe activar antes de que se realice una conexión entre CICS y
WebSphere Application Server.
Si utiliza el sistema de gestión de información (IMS), la interfaz del subsistema externo del adaptador local optimizado debe estar instalada y activada antes de que las aplicaciones empiecen a llamar a las API del adaptador local optimizado.
Procedimiento
- Defina los parámetros que se van a utilizar en la conexión. Al utilizar CICS, el distintivo reg_flag_trans se define en 1 para indicar que las conexiones creadas bajo este nombre de registro se van a conectar a RRS y se van a unir con el trabajo realizado en una transacción global de WebSphere Application Server. Definir este distintivo en 0 (cero) indica que no hay conexiones creadas bajo este nombre de registro que se vayan a conectar a RRS y unir con el trabajo realizado en una transacción global WebSphere Application Server.
Para las llamadas de entrada, siempre se propaga un contexto de seguridad en WebSphere Application Server
y contiene el ID de usuario del espacio de direcciones que realiza la solicitud.
Para CICS, el distintivo reg_flag_C2Wprop propaga el ID de usuario
que está utilizando actualmente la tarea CICS, en lugar del ID de usuario del espacio de direcciones.
Para las llamadas de salida, el distintivo reg_flag_W2Cprop indica a WebSphere Application Server que propague el ID de usuario en CICS. CICS intenta iniciar el programa de destino con dicho ID de usuario.
Si desea obtener
más información sobre el uso de la seguridad, consulte los temas Protección de
los adaptadores locales optimizados para el soporte de entrada y Protección de
los adaptadores locales optimizados para el soporte de salida.
- Compruebe que el nombre de registro no se está utilizando en otra
célula a la que esté conectado este espacio de direcciones. Se
realiza una comprobación del espacio de direcciones para garantizar que el
nombre de registro no se esté utilizando en otra célula. Si se estuviera
utilizando en otra célula, se devolvería un código de retorno de error y se
produciría un error en la solicitud de registro.
- Configure la aplicación de lenguaje nativo del espacio de
direcciones de cliente para que llame a la API BBOA1REG. El grupo de daemon y el nombre del servidor se pasan y una serie de entrada que
representa el nombre, o el nombre del registro utilizado por el daemon WebSphere Application Server.
Un código de razón y retorno
0 (cero) indica que el espacio de direcciones del cliente ahora está enlazado al grupo de daemon WebSphere Application Server y al servidor que ha seleccionado. Las llamadas futuras que interactúan con este WebSphere Application Server deben
tener el nombre de registro proporcionado o un descriptor de conexión específico que se ha creado utilizando el nombre de registro que las acompaña.
Resultados
Después de completar esta tarea, la serie del nombre de registro pasado
se reserva en el espacio de direcciones actual. No se puede realizar ninguna
otra llamada de registro con esta señal hasta que se reciba una llamada para
anular el registro.
Importante: Si utiliza el valor de conexiones
mínimas en esta llamada, el resultado es una agrupación de conexiones que se
establecen previamente con el servidor de destino y esperan a que se produzcan
solicitudes.
Además, se crea un contexto de entrada de registro o bloque
de control y se asocia con la serie de nombre de registro. Cada nombre de
registro exclusivo tiene un contexto de registro.
Varios nombres de registro con el mismo espacio de direcciones y hebra pueden enlazarse con uno o más grupos de daemon
WebSphere Application Server.
Qué hacer a continuación
Para obtener más información sobre la API BBOA1REG, consulte el tema Adaptadores locales optimizados para las API nativas de z/OS.