Para plataformas z/OS

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

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.

Antes de empezar

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

El servidor de 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 TRUE (salida de usuario relacionada con tareas) antes de realizar una conexión entre CICS y el servidor de 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 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.

  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 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.

Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_dat_register
Nombre de archivo:twlp_dat_register.html