
Transacciones del servidor de Liberty para CICS: BBOC, BBO$ y BBO#
Se da soporte a los adaptadores locales optimizados de WebSphere (WOLA) en el producto CICS a través de las transacciones BBOC, BBO$ y BBO#.
Los adaptadores locales optimizados se ejecutan en una región CICS como gestor de recursos. En CICS, el programa TRUE (Task Related User Exit) es el vehículo principal que utilizan los proveedores de recursos. El soporte TRUE ofrece el límite entre las hebras de la aplicación CICS y las hebras del gestor de recursos externo. Actualmente, DB2, WebSphere MQ y los sockets TCPIP se ejecutan en CICS utilizando el soporte TRUE.
- Las aplicaciones ejecutan 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, BBOATRUE, y los parámetros específicos de cada API.
- CICS asigna TRUE en uno de los bloques de control de tareas (TCB) de OPENAPI y se ejecuta hasta que se completa la llamada de la API.
- La llamada regresa a CICS con los parámetros de salida.
Transacción de control para CICS: BBOC
La transacción BBOC es la transacción de control u operaciones de WebSphere para el soporte de adaptadores en CICS. Puede utilizar la transacción para habilitar e iniciar la opción TRUE del servidor de Liberty y para establecer los niveles de rastreo para depurar las API y codificar esas interfaces con el servidor de Liberty. BBOC también define los registros y las anulaciones de registros, e inicia y detiene las tareas del servidor de enlaces en CICS. Estas tareas del servidor proporcionan soporte para iniciar programas CICS existentes y pasar datos con objetos COMMAREA o contenedores con los parámetros de entrada a través de los adaptadores. BBOC es una transacción basada en la estación de trabajo CICS que puede ejecutar el usuario en una estación de trabajo 3270 o en una estación de trabajo secuencial o de tipo SDSCI.
La sintaxis de la transacción BBOC es BBOC nombre_operación parámetros, donde los diversos parámetros se separan mediante uno o más espacios.
- RGN
- El nombre de registro de 12 caracteres
- DGN
- El primer nombre de ocho caracteres del grupo WOLA que se debe unir
- NDN
- El segundo nombre de ocho caracteres del grupo WOLA que se debe unir
- SVN
- El tercer nombre de ocho caracteres del grupo WOLA que se debe unir
- LSYNC
- LSYNC controla si CICS pasa la opción SYNCONRETURN cuando enlaza con el programa de destino. Si especifica LSYNC=Y, el servidor de enlaces CICS pasa la opción SYNCONRETURN en el mandato EXEC CICS LINK. Es posible que tenga que especificar esta opción cuando el programa de destino se halle en otra región CICS. El valor predeterminado es LSYNC=N.
- SVC
- El nombre de servicio de un máximo de 8 caracteres. El parámetro da soporte a la máscara con asteriscos (*); por ejemplo, puede especificar *, abc*, *abc, abc*xyz, abc*xy*z, etc.
- MNC
- El número mínimo de conexiones. El valor mínimo es 0 y el valor predeterminado es 1.
- MXC
- El número máximo de conexiones. El valor máximo es 9999 y el valor predeterminado es 10.
- SEC
- El parámetro SEC controla qué ID de usuario se propaga. El valor predeterminado es SEC=N.
Si especifica SEC=N y está realizando la llamada desde CICS al servidor de Liberty, se propagará el ID de usuario de la región CICS. Si especifica SEC=N y está realizando la llamada desde el servidor de Liberty en CICS bajo la tarea del servidor de enlaces (BBO$), la tarea de enlazar se ejecutará bajo el ID de usuario del servidor de enlaces iniciado.
Si especifica SEC=Y y se está realizando la llamada desde CICS al servidor de Liberty, el ID de usuario de nivel de tarea se propagará al servidor de Liberty. Si especifica SEC=Y y está realizando la llamada desde el servidor de Liberty a CICS, el servidor de enlaces intentará iniciar la tarea de enlaces (BBO#) con el ID de usuario propagado del servidor de Liberty. La propagación solamente funciona si ha creado una definición de clase SURROGAT de System Authorization Facility (SAF) para que permita que el ID de usuario del servidor de enlaces emita el mandato EXEC CICS START TRAN('BBO#') USERID(<ID_propagado>).
- STX
- El nombre de cuatro caracteres del ID de transacciones CICS del servidor de enlaces que se va a utilizar. El valor predeterminado es BBO$.Nota: Si define un nombre de transacción que es distinto del valor predeterminado, también deberá definir la transacción en el archivo de definición de sistema CICS (CSD), DFHCSD, con el mismo nombre de programa y atributos que BBO$.
- LTX
- El nombre de cuatro caracteres del ID de transacciones CICS de enlace a programa que se va a utilizar. El valor predeterminado es BBO#.Nota: Si define un nombre de transacción que es distinto del valor predeterminado, también deberá definir la transacción en el archivo de definición de sistema CICS (CSD), DFHCSD, con el mismo nombre de programa y atributos que BBO#.
- TRC
- La definición de un valor para este parámetro habilita el rastreo en los niveles siguientes:
- Cuando se establece en 0: no se produce el rastreo; solamente aparecen mensajes de error
- Cuando se establece en 1: se realiza un rastreo básico
- Cuando se establece en 2: se realiza un rastreo detallado
- TDQ
- El nombre de cuatro caracteres de la cola de datos transitoria (TDQ) de la partición adicional de CICS donde se graban los mensajes del adaptador. Si no especifica este parámetro, el valor predeterminado es BBOQ y DD BBOUT. Si no se pueden grabar mensajes en la TDWQ especificada, se grabarán en la salida estándar de la región CICS, tdq CESO dd CEEOUT.
- REU
- REU controla si el servidor de enlaces reutiliza las tareas de invocación de enlaces de programa
(transacciones BBO#) entre solicitudes de invocación de programa.Importante: Si ejecuta el servidor de enlaces con SEC=N y REU=Y, el JCA del adaptador local optimizado ya no soportará el paso de un ID de transacciones de enlaces separado. Las solicitudes de un ID de transacciones independiente da como resultado una ResourceException en la aplicación. Si intenta ejecutar el servidor de enlaces con SEC=Y y REU=Y, la opción de reutilización se fuerza en No porque el servidor de enlaces debe iniciar una tarea de enlace de programa nueva para cada solicitud y confirmar la identidad propagada.
- REUC
- El número de solicitudes para las que permanece activa y se reutiliza la tarea de enlaces CICS (BBO#). Cuando se llega a esta cifra, finaliza la tarea de enlace. El valor máximo es 2147483648.Importante: Para un escenario transaccional, finaliza la tarea de enlace tras llegar a la cifra y se recibe la siguiente confirmación del servidor de Liberty.
- REUT
- El número de segundos que permanece activa y se reutiliza la tarea de enlaces CICS (BBO#). Cuando caduca este intervalo de tiempo, tras recibir y procesar la solicitud siguiente, finaliza la tarea de enlace. El valor máximo es 2147483648. Importante: Para un escenario transaccional, finaliza la tarea de enlace tras llegar al tiempo solicitado y se recibe la siguiente confirmación del servidor de Liberty.
| Nombre de operación | Abreviatura | Descripción | Parámetros |
|---|---|---|---|
| START_TRUE | STR | Se inicia la tarea TRUE del servidor de Liberty | TRC=<0|1|2> TDQ=<tdqname> |
| STOP_TRUE | PTR | Se detiene la tarea TRUE del servidor de Liberty | TRC=<0|1|2> TDQ=<tdqname> |
| REGISTER | REG | Se registra con el grupo WOLA del servidor de Liberty | RGN=<nombre> DGN=<nombre> NDN=<nombre> SVN=<nombre> MNC=<número_mínimo_de_conexiones> MXC=<número_máximo_de_conexiones> SEC=<Y|N> TRC=<0|1|2> TDQ=<tdqname> |
| UNREGISTER | Se anula el registro con los adaptadores locales optimizados del servidor de Liberty | RGN=<nombre> | |
| START_SRVR | STA | Se inicia la tarea del servidor de Liberty para el nombre del registro que se ha 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=<Y|N> STX=<ID_transacción_servidor_enlaces_CICS> LTX=<ID_transacción_servidor_enlaces_CICS> TRC=<0|1|2> TDQ=<tdqname> REU=<Y|N> REUC=<número_de_solicitudes> REUT=<número_de_segundos> |
| STOP_SRVR | STP | Se detiene la tarea del servidor de Liberty para el nombre de registro. | RGN=<nombre> TRC=<0|1|2> TDQ=<tdqname> |
Mandatos BBOC de ejemplo
- Iniciar el programa TRUE de CICS de adaptadores.
bboc start_true
- Detener el programa TRUE de CICS de adaptadores.
bboc stop_true
- Registrar con el nombre, CICS-HR1, en el grupo WOLA con los nombres LIB1, LIB2 y LIB3, con un máximo de
10 conexiones, 5 conexiones como mínimo y propagación de seguridad.
bboc register rgn=CICS-HR1 dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y
- Anular el registro con el nombre CICS-HR1.
bboc unregister rgn=CICS-HR1
- Iniciar una transacción del servidor como BBO$ para todos los nombres de servicio y de programa bajo el nombre de registro,
CICSPAYR, con un grupo WOLA con un máximo de 10 conexiones, 5 conexiones como mínimo y propagación de la seguridad.
bboc start_srvr rgn=CICSPAYR dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y
- Detener la transacción del servidor BBO$ que se está ejecutando 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 programa que empiezan por PAYR bajo el nombre de registro, CICSPAY1, con un grupo
WOLA con un máximo de 10 conexiones, 5 conexiones como mínimo y propagación de la seguridad.
bboc start_srvr rgn=CICSPAY1 dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y svc=PAYR*
- Iniciar una transacción de servidor bajo el ID de transacción, PAY2, y registrar con el nombre,
PAYROLL2, para todos los nombres de servicios y programas en un grupo WOLA con un máximo de 10 conexiones, 5 conexiones como mínimo, rastreo básico y propagación de la seguridad.
bboc start_srvr rgn=PAYROLL2 dgn=LIB1 ndn=LIB2 svn=LIB3 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. Registrar con el nombre, PAYROLL3, para los nombres de servicios y programas que empiezan por
PAYRL3 en un grupo WOLA con un máximo de 10 conexiones, 5 conexiones como mínimo, rastreo básico y propagación de la seguridad.
bboc start_srvr rgn=PAYROLL3 dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y svc=PAYRL3* stx=PAY3 ltx=PY3L trc=1
Ejecución automática de un mandato BBOC durante el arranque de CICS
- Para iniciar la tarea TRUE de los adaptadores locales optimizados cuando se inicia CICS, añada BBOACLPT como entrada de fase 2 o de fase 3 en su PLT de CICS.
- Para emitir un mandato BBOC utilizando datos de INITPARM cuando se inicia CICS, añada BBOACLP2 como entrada de fase 2 o de fase 3 en su PLT de CICS.
INITPARM=(BBOACPL2='STA RGN=PAYROLL DGN=LIB1 NDN=LIB2 SVN=LIB3 SVC=*')
INITPARM=(BBOACPL2='REG RGN=LIBAPP DGN=LIB1 NDN=LIB2 SVN=LIB3 MNC=10 MXC=100')
Si crea un registro cuando se inicia CICS, no utilice la API Register en sus aplicaciones. En su lugar, utilice inmediatamente las otras API como, por ejemplo Invoke o Connection Get.
- Ejecutando BBOC STOP_SERVER para todos los servidores de enlace CICS o ejecutando BBOC URG para todos los registros.
- Depurando las tareas BBO$.
- Escribiendo un programa de conclusión PLT (Program List Table - tabla de lista de programas) que ejecute el mandato EXEC CICS LINK en BBOACNTL para cada servidor de enlaces que pase la serie STOP_SERVER.
- Emitiendo el siguiente mandato: CEMT P SHUT,IMMED
Transacción del servidor de enlaces para CICS: BBO$
La transacción BBO$ CICS admite llamadas desde el servidor de Liberty a CICS. La transacción BBO$ es una transacción no de estación de trabajo que representa una instancia de una tarea de servidor que se inicia con la operación BBOC START_SRVR para un determinado nombre de registro y un determinado nombre de servicio. Esta tarea del servidor proporciona la capacidad de invocación de enlaces de programas, que es la posibilidad de iniciar un programa CICS existente desde el servidor de Liberty a través de las API de los adaptadores locales optimizados.Puede alterar temporalmente el nombre de la transacción, BBO$, especificando STX=nombre en el mandato BBOC START_SRVR. Se debe definir el nombre de transacción nuevo en CICS con el mismo nombre de programa y atributos que BBO$. Para obtener más información, consulte Definiciones de adaptadores locales optimizados para CICS.
Transacción de invocación de enlaces de programas para CICS: BBO#
La transacción BBO# CICS admite llamadas desde el servidor de Liberty a CICS. La transacción BBO# es una transacción no de estación de trabajo que representa una instancia de una tarea que inicia la tarea de servidores de enlaces, BBO$, para invocar un enlace de programa. La transacción BBO$ inicia una tarea BBO# para cada solicitud de enlace de programa CICS desde una aplicación del servidor de Liberty.Puede alterar temporalmente el nombre de la transacción, BBO#, especificando LTX=nombre en el mandato BBOC START_SRVR. Se debe definir el nombre de transacción nuevo en CICS con el mismo nombre de programa y atributos que BBO#. Para obtener más información, consulte Definiciones de adaptadores locales optimizados para CICS. De forma alternativa, la aplicación del servidor de Liberty puede pasar el nombre de transacción nuevo a CICS utilizando el método setLinkTaskTransid de JCA.
Tema de referencia