[z/OS]

Transacciones BBOC, BBO$, BBO# de WebSphere Application Server

En este tema se describe cómo se da soporte a los adaptadores locales optimizados en el producto Sistema de control de la información del cliente (CICS), incluidas las transacciones de WebSphere Application Server que se introducen, BBOC, BBO$ y BBO#.

El adaptador se ha diseñado para que se ejecute en una región CICS como gestor de recursos. En CICS, el programa TRUE (Task Related User Exit) es el vehículo principal de los proveedores de recursos. El soporte de TRUE proporciona el límite entre las hebras de la aplicación CICS i las hebras del gestor de recursos externo. Actualmente, los sockets DB2, WebSphere MQ y TCP/IP se utilizan en CICS con el soporte TRUE. Los adaptadores locales optimizados admiten TRUE.

Las aplicaciones que se ejecutan en CICS y que explotan las API de los adaptadores locales optimizados lo hacen llamando a las rutinas de apéndice proporcionadas. Las rutinas de apéndice inician el módulo de interfaz del gestor de recursos CICS, pasándole el nombre de la rutina TRUE del adaptador local optimizado y los parámetros específicos de cada API. CICS ejecuta el programa TRUE en uno de los TCB OPENAPI mantenidos por CICS y se ejecuta hasta que se completa la llamada de API. A continuación, la llamada regresa a CICS con los parámetros de salida. El soporte de TRUE para CICS también proporciona notificación a través de límites de transacción, como cuando la aplicación finaliza de forma normal o anómala, o emite una llamada explícita SYNCPOINT a CICS. Para obtener detalles sobre cómo se utiliza este soporte para propagar el contexto de transacciones a WebSphere Application Server, y sobre el compromiso en dos fases, consulte la sección en este tema sobre "Propagación de transacciones". Adicionalmente, para CICS se proporciona un programa PLTPI (post inicialización de tabla de lista de programa), que puede utilizarse para iniciar el programa TRUE automáticamente durante el arranque de CICS. Si no utiliza PLTPI, se proporciona la transacción BBOC de CICS. Esta transacción puede utilizarse para iniciar, detener, habilitar e inhabilitar el rastreo para el módulo TRUE.

Transacción de control BBOC de WebSphere Application Server para CICS

La transacción BBOC es la transacción de control, o de operaciones, de WebSphere para el soporte de adaptadores en CICS. Se utiliza para habilitar e iniciar el programa TRUE de WebSphere Application Server y para establecer los niveles de rastreo para depurar las API y el código de interfaz de WebSphere Application Server. BBOC también establece registros y anula registros, e inicia y detiene las tareas de servidor de enlaces de WebSphere Application en CICS. Estas tareas de servidor proporcionan soporte para iniciar programas CICS existentes y pasar datos con COMMAREA o contenedores con los parámetros de entrada a través de los adaptadores. Se trata de una transacción basada en terminal de CICS que puede emitirse en un terminal 3270 o desde un terminal secuencial de tipo SDSCI. La sintaxis para BBOC se describe de este modo:

BBOC<nombre_operación><parámetros_separados_por_uno_o_más_espacios>.

Los parámetros se describen de este modo:
  • Nombre de registro - RGN

    El parámetro RGN es el nombre de registro de 12 caracteres.

  • Nombre de grupo de daemons - DGN

    DGN es el nombre de grupo de daemons de ocho caracteres con el que se lleva a cabo el registro.

  • Enlace Sync-on-return - LSYNC

    LSYNC controla si la opción SYNCONRETURN se utiliza al enlazar con el programa de destino en el servidor de enlace. Cuando LSYNC=Y, la opción SYNCONRETURN se pasa a CICS si el programa de destino está enlazado, y utiliza EXEC CICS LINK. Esta opción puede ser necesaria cuando el programa de destino está en otra región de CICS. El valor predeterminado es LSYNC=N.

  • Nombre abreviado de nodo - NDN

    NDN es el nombre abreviado de nodo de ocho caracteres con el que se lleva a cabo el registro.

  • Nombre abreviado de servidor - SVN

    SVN es el nombre abreviado del servidor de destino de ocho caracteres.

  • Nombre de servicio - SVC

    SVC es el nombre de servicio de 8 caracteres como máximo y puede enmascararse con un * (asterisco). Este parámetro da soporte a *, abc*, *abc, abc*xyz, abc*xy*z, etc.

  • Número mínimo de conexiones - MNC

    MNC es el número mínimo de conexiones. El mínimo es 0. El valor predeterminado es 1 si no se proporciona ningún valor.

  • Número máximo de conexiones - MXC

    MXC es el número máximo de conexiones. El número máximo es 99999. El valor por defecto es 10 si no se proporciona ningún valor.

  • Propagación de seguridad - SEC

    SEC es la propagación de seguridad y se establece en Y o N (sí o no). SEC=N es el valor predeterminado. Para SEC=N, y llamando desde CICS a WebSphere Application Server, se propaga el ID de usuario de la región CICS. Para SEC=N y llamando desde WebSphere Application Server a CICS bajo el servidor de enlaces (tarea BBO$), la tarea de enlace se ejecuta bajo el ID de usuario con el que se ha iniciado el servidor de enlace. Para SEC=Y y llamando desde CICS a WebSphere Application Server, el ID de usuario del nivel de tarea se propaga a WebSphere Application Server. Para SEC=Y y llamando desde WebSphere Application Server a CICS, el servidor de enlace intenta iniciar la tarea de enlaces (BBO#) con el ID de usuario propagado desde WebSphere Application Server. Esto sólo funciona si se ha realizado una configuración válida de SURROGAT SAF que permita que el ID de usuario con el que se ejecuta el servidor de enlace emita EXEC CICS START TRAN('BBO#') USERID(<id_propagado>).

  • TXN

    TXN describe el comportamiento transaccional del registro que genera la transacción BBOC.

    Cuando BBOC crea un registro utilizando la operación REGISTER, TXN=Y significa que cualquier aplicación Java Platform, Enterprise Edition que se haya iniciado en WebSphere Application Server utilizando este registro debe unirse a la unidad de trabajo CICS actual. Así se crea una transacción global entre CICS y WebSphere Application Server, que se completa utilizando el protocolo de confirmación en dos fases cuando la aplicación CICS emite un EXEC CICS SYNCPOINT, o cuando está implicado un punto de sincronizació como, por ejemplo, cuando finaliza la tarea CICS.

    Cuando BBOC se utiliza para crear un servidor de enlaces con la función START_SRVR, TXN=Y significa que la tarea de servidor de enlaces CICS debe unirse a la transacción actual de WebSphere Application Server al invocarse un servicio. Por ejemplo, si una aplicación Java Platform, Enterprise Edition inicia una transacción local de gestor de recursos (RMLT) e invoca un programa CICS utilizando el conector JCA de los adaptadores locales optimizados, la tarea de enlace se une a la transacción local y luego invoca el programa CICS de destino. Las actualizaciones realizadas en el programa CICS no se confirman ni se retrotraen hasta que la aplicación Java Platform, Enterprise Edition finaliza la RMLT utilizando la API de confirmación o retrotracción.

  • ID de transacción de CICS del servidor de enlace - STX

    STX es el nombre de cuatro caracteres del ID de transacción CICS del servidor de enlace que debe utilizarse. El valor predeterminado para STX es BBO$.

  • ID de transacción de tarea de enlace - LTX

    LTX es el nombre de cuatro caracteres del ID de transacción CICS del programa para el enlace que debe utilizarse. El valor predeterminado para LTX es BBO#. Si estos nombres de transacción se sustituyen por nombre proporcionados por el usuario, deben definirse con el mismo nombre de programa y los mismos atributos que BBO$ (para STX) y BBO# (para LTX).

  • Rastreo - TRC
    El rastreo se habilita y define durante el proceso de cualquiera de los mandatos enumerados en la tabla. Existen tres niveles de rastreo:
    • 0 = ninguno y mensajes de error únicamente
    • 1 = básico
    • 2 = detallado
  • Cola de datos transitoria - TDQ

    Los datos de rastreo en CICS se escriben en la TDQ de la partición adicional que se solicita. El parámetro TDQ especifica un nombre de cuatro caracteres de la TDQ de partición adicional de CICS en la que se deben escribir los mensajes del adaptador. Si no se proporciona el nombre de cuatro caracteres, el valor predeterminado es BBOQ y DD BBOOUT. Si existe algún problema para escribir en la TDQ seleccionada, los mensajes se escriben en la salida estándar (stdout) de la región de CICS (tdq CESO dd CEEOUT).

  • Reutilizar-REU
    Si se determina que el servidor de Enlaces puede ejecutarse con SEC=N, se consigue el mejor rendimiento ejecutando también con el parámetro REU=Y BBOC START_SRVR. REU=Y hace que el servidor de enlace vuelva a utilizar las tareas de invocación de enlace de programa (transacciones BBO#) entre las solicitudes de invocación de programa.
    Importante: Si ejecuta el servidor de enlace en esta configuración, el soporte del JCA de los adaptadores locales optimizados para pasar un ID de transacción LINK independiente para solicitudes individuales se inhabilita y al solicitarlo se genera una excepción ResourceException que se devuelve a la aplicación. Asimismo, si intenta seleccionar REU=Y y SEC=Y, se fuerza la opción de reutilización a No porque el servidor de enlace debe iniciar una nueva tarea de enlace de programa para cada solicitud aseverando la identidad que se ha propagado.
  • Número de reutilizaciones - REUC
    Especifique el número de solicitudes durante las que la tarea de enlace CICS (BBO#) permanece activa y se reutiliza. Cuando se alcanza este número, la tarea de enlace termina. El valor máximo es 2147483648.
    Importante: En el caso de un escenario transaccional, la tarea de enlace termina una vez que se alcanzado el número y se ha recibido la siguiente confirmación desde el servidor de aplicaciones.
  • Tiempo de utilización - REUT
    Especifique el número de segundos durante el que la tarea de enlace CICS (BBO#) permanece activa y se reutiliza. Cuando caduca este intervalo de tiempo, después de recibir y procesar la siguiente solicitud, la tarea de enlace termina. El valor máximo es 2147483648.
    Importante: En el caso de un escenario transaccional, la tarea de enlace termina una vez que se alcanzado el tiempo solicitado y se ha recibido la siguiente confirmación desde el servidor de aplicaciones.
  • Nombre de cola de almacenamiento temporal de lista de servidores de enlace - LTSQ

    LTSQ sólo se aplica a la operación LIST_SRVR. LTSQ es el nombre de una cola de almacenamiento temporal de CICS donde se escribe la lista de servidores de enlace y la información de cada uno. Puede ser una serie de caracteres con un máximo de 8 caracteres de longitud. Un archivo de cabecera C que muestra el formato de los registros de salida se proporciona en /<raíz_instalación>/AppServer/util/zos/OLASamples/bboaapic.h y se describe en la estructura tsq_record.

Tabla 1. BBOC. En la tabla siguiente se resumen los nombres, las descripciones y los parámetros de las operaciones de BBOC.
Nombre de operación Abreviatura Abreviatura,

Descripción

Parámetros
START_TRUE STR Iniciar el programa TRUE de WebSphere Application Server. TRC=0/1/2

TDQ=<nombre_tdq>

STOP_TRUE PTR Detener el programa TRUE de WebSphere Application Server TRC=0/1/2

TDQ=<nombre_tdq>

REGISTER REG Regístrese con el grupo de daemons de adaptadores locales optimizados, el nodo y el servidor de WebSphere Application Server RGN=<nombre>

DGN=<nombre>

NDN=<nombre>

SVN=<nombre>

MNC=<número_mínimo_de_conexiones>

MXC=<número_máximo_de_conexiones>

SEC=<sí|no>

TXN=<sí|no>

TRC=0|1|2

TDQ=<nombre_tdq>

UNREGISTER   Anular el registro con los adaptadores locales optimizados de WebSphere Application Server. RGN=<nombre>
START_SRVR STA Iniciar la tarea de WebSphere Application Server para el nombre de registro pasado. RGN=<nombre>

DGN=<nombre>

NDN=<nombre>

SVC=<nombre>

SVN=<nombre>

MNC=<número_mínimo_de_conexiones>

MXC=<número_máximo_de_conexiones>

SEC=<yes|no>

STX=<ID_transacción_servidor_enlace_CICS>

LTX=<ID_transacción_servidor_enlace_CICS

TRC=0|1|2

TDQ=<nombre_tdq>

REU=<yes|no>

REUC=<número_de_solicitudes>

REUT=<número_de_segundos>

STOP_SRVR STP Detener la tarea de WebSphere Application Server para el nombre de registro. RGN=<nombre>

TRC=0/1/2

TDQ=<nombre_tdq>

LIST_SRVR LST Lista de todos los servidores de enlace que coinciden con el que se ha pasado en Nombre de registro. Los parámetros son todos opcionales, incluido el nombre de registro. Si se emite sin parámetros, devuelve una lista de todos los servidores de enlace. También puede pasar el parámetro RGN con comodines. Un asterisco (*) indica que todos los caracteres después de ese punto son válidos y un signo de interrogación (?) significa que un carácter único puede ser cualquier carácter. La salida de la operación LIST_SRVR se escribe en el BBOQ o en la cola de datos transitorios indicada en el parámetro TDQ. Si se pasa el parámetro LTSQ, la lista de servidores de enlace activos se escribe en la cola de almacenamiento temporal CICS especificada. RGN=<nombre>

LTSQ=<nombre_cat>

TRC=<0/1/2>

TDQ=<nombre_tdq>

Ejecución automática de un mandato BBOC durante el inicio y la conclusión de CICS

Puede iniciar automáticamente un servidor de enlace de adaptadores locales optimizados cuando se inicia CICS. Esto inicia una tarea BBO$ de larga ejecución que existe hasta que el servidor de enlace se detiene. Para ejecutar mandatos BBOC durante el inicio de CICS, se proporcionan dos programas PLTPI (Program List Table Post-Initialization) de CICS en la biblioteca de carga creada por el script copyZOS.sh. Esta biblioteca de carga se puede utilizar para ejecutar mandatos BBOC durante el inicio de CICS. Añada BBOACPLT a CICS PLT como una entrada de fase 2 o fase 3 si desea habilitar la salida de usuario relacionada con tareas (TRUE) de los adaptadores locales optimizados durante el inicio de CICS.

Se proporciona un segundo programa PLTPI, BBOACPL2, que, cuando se añade a PLT (también en la fase 2 o 3) permite emitir un mandato BBOC durante el inicio de CICS utilizando datos INITPARM. Puede pasar una serie de mandatos dentro de INITPARM (hasta el límite de CICS de 60 caracteres). La siguiente serie INITPARM de ejemplo llama a BBOACPL2 y pasa una solicitud para iniciar un servidor de enlace con el nombre de registro 'PAYROLL' con el número de grupo de daemons 'DAE1', nombre de nodo 'NODE1' y nombre de servidor 'SERVER1'. Este servidor de enlace recibe solicitudes para todos los nombres de servicio (SVC=*):
INITPARM=(BBOACPL2='STA RGN=PAYROLL
DGN=DAE1 NDN=NODE1 SVN=SERVER1 SVC=*') 
La serie de mandato puede ser cualquier mandato BBOC. Si desea configurar un registro con el nombre WASAPP formado por un mínimo de 10 conexiones y un máximo de 100 durante el inicio de CICS, debe especificar lo siguiente:
INITPARM=(BBOACPL2='REG RGN=WASAPP DGN=DAE1 NDN=NODE1 SVN=SERVER1 MNC=10 MXC=100')
Con esto, no debe utilizar la API de registro en sus aplicaciones. En su lugar debe utilizar las demás API directamente, por ejemplo, Invoke, Connection Get y Send Request, etc.
Importante: Existe una limitación de CICS por la cual solamente puede existir un solo INITPARM por cada programa (BBOACPL2). Por lo tanto, puede realizar esta operación una vez en los parámetros de arranque de CICS.

El origen y el JCL para los programas PLTPI BBOACPLT y BBOACPL2 suministrados se proporciona en /<raíz_instalación>/AppServer/util/zos/OLASamples como archivos bboacplt.jclsamp y bboacpl2.jclsamp. También se suministra otro programa PLTPI de ejemplo. En /<raíz_instalación>/AppServer/util/zos/OLASamples/bboacpl3.jclsamp se proporciona un ejemplo que muestra cómo emitir varios mandatos BBOC durante el inicio de CICS.

También hay JCL de ejemplo que muestra cómo ensamblar PLT con estos programas incluidos en /<raíz_instalación>/AppServer/util/zos/OLASamples/DFHPLTOL.jclsamp.

Detener servidores de enlaces durante la conclusión CICS

Es necesario desregistrar y detener todos los servidores de enlace en ejecución antes de concluir CICS para que pueda haber una conclusión normal. Puede realizar una de las acciones siguientes para desregistrar y detener un servidor de enlace antes o durante la conclusión de CICS:

  • Ejecute BBOC STOP_SERVER para todos los servidores de enlace CICS antes de concluir CICS
  • Añada el fuente BBOACPLS del programa PLTSD (Program List Table Shutdown) proporcionado por IBM® a la PLT de conclusión. Este PLTSD ejecuta un BBOC LIST_SRVR para identificar todos los servidores de enlace en ejecución de la región y luego emite una operación STOP_SRVR para cada servidor. Un JCL de ejemplo que muestra cómo añadirlo a su lista de conclusión de PLT se proporciona en /<raíz_instalación>/AppServer/util/zos/OLASamples/DFHPLTO2.jclsamp
  • Depurar las tareas BBO.
  • Escriba un programa de conclusión de PLT por el cual se emite STOP_SERVER para los enlaces CICS con BBOACNTL de cada servidor de enlace.
  • Emita CEMT P SHUT,IMMED

Ejecución de un mandato BBOC desde un programa mediante EXEC CICS LINK PROGRAM('BBOACNTL')

Puede ejecutar operaciones BBOC desde programas utilizando EXEC CICS LINK PROGRAM('BBOACNTL') y pasando la serie del mandato en la COMMAREA. Si la longitud de la serie del mandato en la COMMAREA pasada es menor que 268 caracteres, se devuelve una serie que sólo contiene el resultado de la ejecución del mandato. Si la longitud es igual o mayor que 268 caracteres, BBOC/BBOACNTL proporciona una versión, código de retorno y código de razón en los bytes 256 - 268 en forma de números enteros. A continuación se muestra la estructura del área devuelta para la Versión 1:

/* Version 1 DFHCOMMAREA - for EXEC CICS LINK to BBOACNTL */

 struct inputCommarea {
   char command[256];
 };

 struct outputCommarea_v1 {
   char message[256];
   int version;
   int returnCode;
   int reasonCode;
 };

 struct BBOACNTL_Commarea {
   union {
     struct inputCommarea input;
     struct outputCommarea_v1 output;
   };
 };

Cuando se pasa una COMMAREA mayor que o igual a 268 bytes como entrada a BBOACNTL, se obtiene una respuesta de mensaje en los primeros 256 bytes seguida del el área mostrada anteriormente con la versión, el código de retorno y código de razón de la operación ejecutada por BBOC/BBOACNTL. A continuación figuran los códigos de retorno y razón soportados de la operación EXEC CICS LINK en BBOACNTL:

RC 0 RSN 0
		Proceso de solicitud satisfactorio. El mensaje de
respuesta en los primeros 256 bytes proporciona más información. Busque en
el Information Center con el ID del mensaje devuelto para obtener más
información sobre la respuesta.
RC 4 RSN 0
   No hay servidores de enlace coincidentes con el nombre de registro solicitado o no hay servidores de enlace en ejecución en esta región. El mensaje de
respuesta en los primeros 256 bytes proporciona más información. Busque en
el Information Center con el ID del mensaje devuelto para obtener más
información sobre la respuesta.
RC 8 RSN 0 o superior
   Se ha producido un error en el proceso de la solicitud. El mensaje de
respuesta en los primeros 256 bytes proporciona más información. Busque en
el Information Center con el ID del mensaje devuelto para obtener más
información sobre la respuesta.
RC 12 RSN 0 o superior
   Se ha producido un error grave en el proceso de la solicitud. El mensaje de
respuesta en los primeros 256 bytes proporciona más información. Busque en
el Information Center con el ID del mensaje devuelto para obtener más información sobre la respuesta.

Si se pasa el parámetro LTSQ en la serie de mandatos para la llamada EXEC CICS LINK a BBOACNTL se graba una lista de servidores de enlace activos correspondientes en la cola de almacenamiento temporal de CICS que se ha pasado en el parámetro LTSQ. El formato de registro de salida para cada servidor de enlace de la lista está documentado en la cabecera que se encuentra en: /<raíz_instalación>/AppServer/util/zos/OLASamples/bboaapic.h y se describe en la estructura tsq_record.

Tarea de servidor de enlaces de WebSphere Application Server LINK para CICS, BB0$

La transacción CICS, BBO$, se utiliza para obtener soporte de llamadas de salida de WebSphere Application Server a CICS. Se ejecuta en segundo plano como una transacción que no es de terminal y representa una instancia de una tarea de servidor que se inicia utilizando la operación BBOC START_SRVR para un nombre de registro y un nombre de servicio especificados por el usuario. Esta tarea de servidor proporciona una capacidad de invocación de enlace (LINK) de programa, o la capacidad de iniciar un programa CICS existente desde WebSphere Application Server a través de las API de los adaptadores locales optimizados. El nombre de esta transacción puede sustituirse por un nombre especificado por el usuario que puede indicarse en el mandato BBOC START_SRVR (STX=xxxx). Si se hace, el nombre de transacción proporcionado debe definirse para CICS con el mismo nombre de programa y los mismos atributos que BBO$.

Tarea de invocación de enlace (LINK) de programa de WebSphere Application Server para CICS, BBO#

La transacción CICS, BBO#, se utiliza para obtener soporte de llamadas de salida de WebSphere Application Server a CICS. Se trata de una transacción que no es de terminal que representa una instancia de una tarea iniciada por la tarea de servidor de adaptadores de WebSphere Application Server, BBO$, para llevar a cabo una invocación de enlace de programa. La transacción BBO$ inicia una transacción BBO# para cada solicitud de enlace de programa CICS desde una aplicación que se despliega en WebSphere Application Server.

El nombre de esta transacción puede sustituirse por un nombre especificado por el usuario que puede indicarse en el mandato BBOC START_SRVR, por ejemplo, LTX=xxxx. Se se hace, el nombre de la transacción que se proporciona debe definirse en CICS con el mismo nombre de programa y los mismos atributos que la transacción BBO#. Alternativamente, el nombre de 4 caracteres de la transacción de enlace puede pasarse de WebSphere Application Server a través de la aplicación que utiliza JCA. En este escenario, la aplicación que utiliza el adaptador utiliza el método setLinkTaskTransid.

Aserción de la identidad de usuario desde WebSphere Application Server a CICS

Esta tarea de servidor da soporte a la propagación de la identidad de usuario desde una llamada de WebSphere Application Server a CICS y a la confirmación de dicha identidad. Esta aserción sólo se lleva a cabo si la tarea de registro se ha realizado con el parámetro de seguridad definido con el valor SEC=Y. Esto se implementa mediante EXEC CICS START TRANSACTION(‘BBO#') USERID(<ID_usuario>).

Se debe definir una clase SAF SURROGAT para garantizar que el ID de usuario bajo el que se ejecuta la transacción BBO$ tenga autorización para iniciar una transacción en nombre del ID de usuario que se ha pasado.

Si ejecuta BBOC STRT_SRVR con SEC=N el ID de usuario asociado con las solicitudes de entrada para CICS es el ID de usuario que ha ejecutado la transacción BBOC.

Invocaciones de BBOC de ejemplo

A continuación se ofrecen ejemplos de invocaciones de BBOC en los que se muestra cómo pueden llevarse a cabo distintas tareas y configuraciones con el soporte de enlace de programa de adaptadores CICS.
  • Iniciar el programa TRUE de CICS de adaptadores.

    bboc start_true

  • Detener el programa TRUE de CICS de adaptadores.

    bboc stop_true

  • Registrarse con el nombre CICS-HR1, en el grupo de daemons SY1, con el nodo SY1, y con el servidor BBOS001, con un máximo de 10 conexiones y un mínimo de 5. Establecer la transacción en no y la propagación de seguridad en .

    bboc register rgn=CICS-HR1 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 txn=n sec=y

  • Anular el registro con el nombre CICS-HR1.

    bboc unregister rgn=CICS-HR1

  • Iniciar una transacción de servidor como BBO$ para todos los nombres de servicio y programa con el nombre de registro CICSPAYR, con un grupo de daemons, un nodo y un servidor con 10 conexiones como máximo y 5 como mínimo. Establecer la transacción en no y la propagación de seguridad en .

    bboc start_srvr rgn=CICSPAYR svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y

  • Detener la transacción de servidor BBO$ que se ejecuta bajo el nombre de registro CICSPAYR.

    bboc stop_srvr rgn=CICSPAYR

  • Iniciar una transacción de servidor como BBO$ para los nombres de servicio y de programa que empiezan por PAYR bajo el nombre de registro CICSPAY1, con un grupo de daemons, un nodo y un servidor con 10 conexiones como máximo y 5 como mínimo. La transacción es no y la propagación de seguridad es .

    bboc start_srvr rgn=CICSPAY1 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y svc=PAYR*

  • Iniciar una transacción de servidor bajo el ID de transacción PAY2, y registrarse con el nombre PAYROLL2, para todos los nombres de servicio y de programa en un grupo de daemons, un nodo y un servidor con 10 conexiones como máximo y 5 como mínimo. El valor del parámetro de transacción es , el valor de propagación de seguridad es y el nivel de rastreo se establece en 1.

    bboc start_srvr rgn=PAYROLL2 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y stx=PAY2 trc=1

  • Iniciar una transacción de servidor con el ID de transacción PAY3, y el ID de transacción de enlace PY3L. Registrarse con el nombre PAYROLL3, para los nombres de servicio y de programa que empiezan por PAYRL3 en un grupo de daemons, un nodo y un servidor con 10 conexiones como máximo y 5 como mínimo. El valor del parámetro de transacción es y el valor del parámetro de propagación de seguridad es con el nivel de rastreo establecido en 1.

    bboc start_srvr rgn=PAYROLL3 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y svc=PAYRL3* stx=PAY3 ltx=PY3L trc=1

  • Listar todos los servidores de enlace que se ejecutan en esta región CICS

    bboc list_srvr

  • Listar todos los servidores de enlace que se ejecutan en esta región CICS con un nombre de registro CICSPAY1

    bboc list_srvr rgn=CICSPAY1

  • Listar todos los servidores de enlace que se ejecutan en esta región CICS que empiezan por un nombre de registro de CICS y copiar la lista en una cola de almacenamiento temporal denominada MYSRVRS

    bboc list_srvr rgn=CICS* ltsq=MYSRVRS

  • Listar todos los servidores de enlace que se ejecutan en esta región CICS que empiezan con un nombre de registro que empieza por 'CICS', a continuación cualquier carácter seguido de 'ZZZ' y cualquier otro carácter después de eso

    bboc list_srvr rgn=CICS?ZZZ*

Soporte para objetos de canales y de contenedor de CICS

Para los mensajes de más de 32 K, los programas de aplicación de CICS que se inician desde WebSphere Application Server deben poder recibir datos y enviar datos de respuesta utilizando canales y contenedores de CICS. Las aplicaciones que se despliegan en WebSphere Application Server pueden utilizar la interfaz de programación JCA suministrada para proporcionar el nombre y el tipo (BIT|CHAR) del contenedor de CICS que pasa datos al programa de destino, y el nombre y el tipo de contenedor que recibe la respuesta de la aplicación.

Existen dos maneras de pasar canales y contenedores a CICS. En ambos casos, el método setUseCICSContainer() de ConnectionSpecImpl se debe establecer en '1'.
  • Cuando se pasa un solo contenedor y se recibe un solo contenedor, se pueden utilizar los métodos setLinkTaskReqContid, setLinkTaskRspContid, setLinkTaskReqContType(bit|char) y setLinkTaskRspContType(bit|char). Tanto para la solicitud como para la respuesta, se utiliza el nombre de canal, IBM-IBM-WAS-ADAPTER. Este nombre de canal es fijo.
  • Como alternativa, se puede utilizar la interfaz MappedRecord de JCA para enviar y recibir uno o varios contenedores desde un programa CICS de destino. Al utilizar MappedRecord, utilice los métodos setLinkTaskChanID() y setLinkTaskChanType() de ConnectionSpecImpl para establecer el nombre de canal que se utilizará para contener los contenedores de solicitud y respuesta, así como el tipo de contenedores (bit o char) que se contendrán en el canal.

    Los nombres de los contenedores de solicitud individuales se establece mediante la adición de datos a MappedRecord, utilizando el método put().

    Las claves de MappedRecord corresponden a los nombres de contenedor CICS y el valor correspondiente se utiliza para rellenar el contenedor en CICS. La clave debe ser un objeto de serie con una longitud de entre 1 y 16 caracteres. El valor puede ser un byte[] o un objeto RecordBytes generado por herramientas como Rational Application Developer.

    Los nombres de los contenedor de respuesta se extraen del canal después de que la solicitud CICS haya finalizado y se llena en un nuevo MappedRecord, que se devuelve al cliente.


Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rdat_cics
File name: rdat_cics.html