Registro de un espacio de direcciones externo con un servidor Liberty local utilizando adaptadores locales optimizados

Para que los adaptadores locales optimizados de WebSphere (WOLA) realicen una llamada de salida al grupo de adaptadores locales optimizados o una llamada de entrada a un servidor Liberty, debe enlazar el espacio de direcciones actual al servidor Liberty y establecer los atributos de conexión mediante la API Register.

Antes de empezar

Habilite el entorno de servidor de Liberty para utilizar WOLA. Para obtener más información, consulte Habilitación del entorno de servidor Liberty para utilizar adaptadores locales optimizados.

El servidor Liberty debe estar activo en la misma imagen de z/OS desde donde se origina la solicitud de registro.

Si está utilizando CICS (Customer Information Control System), habilite el soporte de adaptadores locales optimizados en CICS. Para obtener más información, consulte Habilitación del soporte para adaptadores locales optimizados de Liberty en CICS. Active el programa de salida de usuario relacionada con la tarea (TRUE) antes de realizar una conexión entre CICS y el servidor Liberty.

Procedimiento

  1. 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 las llamadas de entrada al servidor Liberty, un contexto de seguridad que contiene el ID de usuario del espacio de direcciones que realiza la solicitud siempre se propaga en el servidor Liberty. 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 del servidor Liberty, el distintivo de registro reg_flag_W2Cprop indica al servidor 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 Las API de los adaptadores locales optimizados en Liberty for z/OS y Protección de adaptadores locales optimizados en Liberty para z/OS.

  2. 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.
  3. 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 razón 0 indica que el espacio de direcciones de cliente ahora está enlazado al servidor 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. Varios nombres de registro con el mismo espacio de direcciones y hebra pueden enlazarse a uno o varios grupos de adaptadores locales optimizados de Liberty.

Qué hacer a continuación

Puede utilizar el registro para realizar llamadas de entrada y 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.

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_dat_register.html