For z/OS platforms

Habilitación del soporte para adaptadores locales optimizados de Liberty en CICS

Debe habilitar el entorno Customer Information Control System (CICS) para que reciba solicitudes de entrada y de salida utilizando los adaptadores locales optimizados de WebSphere (WOLA).

Antes de empezar

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

Procedimiento

  1. Añada las definiciones de recursos CICS para los adaptadores locales optimizados en el archivo primario de definición de sistema CICS (CSD), DFHCSD. Puede añadir las definiciones en CICS manualmente o descargar y ejecutar el ejemplo CSUPDAT.
    • En CICS, utilice la transacción CEDA o una transacción equivalente para añadir las definiciones al DFHCSD. Consulte en Definiciones de adaptadores locales optimizados para CICS las definiciones necesarias.
    • Utilice el programa de actualización CSD fuera de línea de CICS, DFHCSDUP, para añadir las definiciones a DFHCSD. Para obtener más información sobre el programa DFHCSDUP, consulte la documentación de su versión de CICS. Consulte en Definiciones de adaptadores locales optimizados para CICS las definiciones necesarias.
    • Actualice las definiciones ejecutando el trabajo de ejemplo CSDUPDAT.jclsamp.
      1. Descargue los ejemplo de adaptadores locales optimizados. Para obtener más información sobre cómo descargar e instalar los ejemplo, consulte Ejemplos de adaptadores locales optimizados para Liberty.
      2. Copie los ejemplos y el miembro CSDUPDAT en un conjunto de datos.
      3. Personalice el trabajo de ejemplo CSDUPDAT.jclsamp para su entorno. Por ejemplo, en el trabajo de ejemplo, escriba el nombre del conjunto de datos donde se halla CSD.
      4. Ejecute el trabajo de ejemplo CSDUPDAT.jclsamp.
  2. Copie los módulos de carga y archivos DLL que son necesarios para CICS del sistema de archivos jerárquico (HFS) del servidor Liberty o del sistema de archivos de zSeries (zFS) en un conjunto de datos particionados para ser utilizados en CICS. En el ejemplo siguiente se muestra cómo copiar módulos de carga en el conjunto de datos $DSNAME:
    cp -Xv wlp/clients/zos/* "//'$DSNAME'" 
  3. Coloque el conjunto de datos en la concatenación DFHRPL de CICS.
  4. Configure el catálogo de mensajes de Liberty en la región CICS. Los programas de adaptadores locales optimizados emiten mensajes desde un catálogo de mensajes que se entrega con Liberty. Para que los programas emitan mensajes, la variable de entorno NLSPATH de la región CICS debe apuntar al directorio que contiene el catálogo de mensajes. Este directorio es wlp/lib/native/zos/s390x/nls/%N.cat, donde wlp es el directorio en el que se ha instalado el servidor de Liberty.

    Para establecer la variable de entorno, utilice la opción ENVAR de Language Environment que puede establecer editando el valor CEEROPT CSECT que utiliza la región CICS. Después de editar el valor CSECT, puede crear, compilar, enlazar y copiar el valor CSECT en el conjunto de datos de DFHRPL. Para obtener más información sobre otras formas de definir las opciones de Language Environment (entorno de lenguaje), consulte la documentación de su versión de CICS.

    Nota: No se da soporte a las formas de establecer las opciones de Language Environment que implican editar el código de origen de aplicaciones o volver a enlazar la aplicación porque los programas de los adaptadores locales optimizados no se pueden volver a compilar o volver a enlazar.
    El ejemplo siguiente muestra CEEROPT CSECT que define la variable de entorno NLSPATH para un servidor de Liberty que está instalado en /u/MSTONE1/wlp. Fíjese que la definición abarca dos líneas e incluye un carácter de continuación, X, en la columna 72.
    CEEROPT CSECT
    CEEROPT AMODE ANY
    CEEROPT RMODE ANY
    *****************************************************************
    *
    * Programa de utilidad: CEEROPT
    * Finalidad: Definir las opciones de tiempo de ejecución de LE predeterminadas para la región CICS.
    *
    *****************************************************************
            CEEXOPT ENVAR=(('NLSPATH=/u/MSTONE1/wlp/lib/native/zos/s390x/nlX
                   s/%N.cat'),OVR)
            END
  5. Proteja sus conexiones de adaptadores locales optimizados llevando a cabo las acciones siguientes:
    • Cree los perfiles SERVER para z/OS.
    • Si ha habilitado CBIND en System Authorization Facility (SAF), otorgue acceso a los clientes que van a utilizar los adaptadores locales optimizados.

    Para obtener más información, consulte Protección de adaptadores locales optimizados para soporte de entrada en Liberty para z/OS.

  6. Inicie el programa de salida de usuario relacionada con tareas (TRUE) de los adaptadores locales optimizados.

    Puede iniciar el programa TRUE con BBOC, una transacción de adaptadores locales optimizados para CICS. Puede utilizar esta transacción para iniciar, detener, habilitar e inhabilitar el rastreo para el módulo TRUE. El nombre del programa TRUE es BBOATRUE, que podrá activar utilizando la transacción BBOC con el parámetro START_TRUE.

    Cuando la seguridad CICS está habilitada, el ID de usuario donde se ejecutan los parámetros BBOC START_TRUE y STOP_TRUE debe tener la autoridad para emitir los mandatos EXEC de CICS ENABLE PROGRAM(BBOATRUE) y DISABLE PROGRAM(BBOATRUE) EXITALL. Los mensajes que emite el servidor de Liberty bajo CICS se direccionan a la cola de datos transitorios (TDQ) de la partición adicional BBOQ que se ha asignado bajo DD BBOOUT en la región CICS.

    Para obtener más información, consulte Transacciones del servidor de Liberty para CICS: BBOC, BBO$ y BBO#.

  7. Opcional: Si desea utilizar el servidor de enlaces CICS, inicie la tarea del servidor de enlaces CICS de los adaptadores locales optimizados emitiendo el mandato BBOC_START_SRVR en una estación de trabajo CICS. Para obtener más información, consulte Transacciones del servidor de Liberty para CICS: BBOC, BBO$ y BBO#.

Qué hacer a continuación

Si desea crear una conexión, empiece registrando el espacio de direcciones externo en el servidor Liberty. Para obtener más información, consulte Registro de un espacio de direcciones externo con un servidor Liberty local utilizando adaptadores locales optimizados.


Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_dat_enableconnectorcics.html