Utilice la pestaña Filtrado en el editor de enlaces de sucesos de CICS para definir criterios, llamados predicados, para capturar sucesos.
Si no proporciona predicados, se emitirán sucesos cada vez que el punto de captura que haya seleccionado se ejecute en el sistema CICS de destino.
Cada predicado consiste en información que identifica al predicado, un operador y un valor. Puede especificar tantos
predicados como desee para identificar la situación en la que desea que este punto de captura emita un suceso. Los tres tipos de predicados que puede especificar son Contexto, Opciones de suceso y Datos de aplicación.
Algunos puntos de captura tienen un predicado primario. Para un predicado primario debe seleccionar el valor de Operador Igual a y proporcionar un valor para evitar
que tenga un impacto negativo en el rendimiento a medida que añade más especificaciones de captura en un punto de captura.
Nota: Los nombres de módulo CICS pueden cambiar; por lo tanto, no incluya filtros que contengan nombres de módulo DFH* en las especificaciones de captura. El editor de enlaces de sucesos de CICS valida la entrada de los usuarios al codificar los nombres de la mayoría de módulos DFH* en el filtro de programa actual. Los usuarios sólo pueden codificar DFH£*, DFH0*, DFHW2FI, DFHW2TS, DFHMQBP0
o DFHECID.Además, DFHMIRR y DFHMIRS pueden codificarse para el suceso de aplicación LINK PROGRAM.
Contexto
Los predicados de la especificación de captura se utilizan para filtrar el contexto del punto de captura.
Cada punto de captura tiene elementos de contexto para los que puede especificar predicados. Un ejemplo, es el ID de transacción. Todos los predicados de contexto disponibles se muestran en la pestaña Filtrado.
Los predicados de contexto son opcionales; no obstante, normalmente se especifica el ID de transacción o el programa actual para emitir sucesos desde una aplicación determinada.
El área de contexto se utiliza para establecer opciones
de filtrado para sucesos.
Según otra información que proporcione en el editor de enlaces de sucesos de CICS, no todos los campos son relevantes; los predicados de contexto disponibles dependen del punto de captura. Los predicados que puede que desee especificar son: ID de transición, programa actual e ID de usuario.
- ID de transacción
- Opciones de operador para todos los puntos de captura:
- Todo
- Igual a
- No es igual a
- No empieza por
- Empieza por
Opciones adicionales para los puntos de captura de aplicación:
- Inferior a
- No es inferior a
- Superior a
- No es superior a
- Programa actual
- Opciones de operador para todos los puntos de captura:
- Todo
- Igual a
- No es igual a
- No empieza por
- Empieza por
- Inferior a
- No es inferior a
- Superior a
- No es superior a
- ID de usuario
- Opciones de operador para todos los puntos de captura:
- Todo
- Igual a
- No es igual a
- No empieza por
- Empieza por
Opciones adicionales para los puntos de captura de aplicación:
- Inferior a
- No es inferior a
- Superior a
- No es superior a
- Código de respuesta
- Opciones de operador:
- Los valores del operador igual a incluyen:
Opciones de suceso
Los predicados de la especificación de captura se utilizan para filtrar los valores de opciones de sucesos de un mandato CICS o suceso del sistema.
Cada punto de captura puede tener opciones de suceso para las que puede especificar predicados. Algunos mandatos no tienen opciones de suceso. Las opciones de suceso corresponden a las opciones de un mandato EXEC CICS o suceso del sistema específico. Un ejemplo de mandato SEND MAP es el nombre MAP. Un ejemplo del suceso de estado de conexión DB2 es el estado FROM_CONNECTST. Todos los valores de datos fijos disponibles para el punto de captura se muestran en la pestaña
Filtrado.
El formato de las opciones de suceso es conocido para CICS.
- Nombre
- El nombre de la especificación de la captura.
- Operador
- Opciones de operador para todos los puntos de captura:
- Todo
- Igual a
- No es igual a
- No empieza por
- Empieza por
Opciones adicionales para los puntos de captura de aplicación:
- Todo
- Igual a
- No es igual a
- No empieza por
- Empieza por
Opciones adicionales para los puntos de captura de sistema:
- Es superior a
- Es inferior a
- Valor
- El valor que especifique para el predicado.
- Los límites del predicado de opción de mandato de aplicación varían según la
API de CICS. Por ejemplo, TRANSID tiene 4 caracteres y CHANNEL
16 caracteres. El editor de enlaces de sucesos de CICS se ajusta dinámicamente para cada tipo y muestra un mensaje si el valor del predicado es demasiado largo o demasiado corto.
Para obtener más información sobre las opciones de suceso para las llamadas de API
de CICS, consulte Sucesos de aplicación en el Information Center de CICS TS 5.1 .
Para obtener más información sobre las opciones de suceso para los sucesos del sistema, consulte Sucesos de sistema en el Information Center de CICS TS 5.1 y Pestaña Fuentes de información en el Information Center de CICS TS 5.1 .
Datos de aplicación
Los predicados de la especificación de captura se utilizan para filtrar los datos de aplicación especificados en un mandato CICS.
Nota: No puede añadir datos de aplicación cuando un punto de captura de DELETEQ TD o DELETEQ TS está definido para una especificación de captura.
Los puntos de captura de aplicación pueden tener valores de datos de longitud variable para los que puede especificar predicados. Los datos de aplicación corresponden con las opciones
de un mandato EXEC de CICS en particular. Un ejemplo de mandato SEND MAP es el campo FROM. Todos los valores de datos variables disponibles
para el mandato EXEC de CICS para el punto de captura están en la pestaña
Filtrado.
CICS procesa los predicados de datos de aplicación en el orden especificado; es decir, se procesa el primer predicado, después el segundo predicado, etc.
Los datos de aplicación se utilizan en áreas de almacenamiento como COMMAREA o contenedores que se pasan como opciones en los mandatos CICS. CICS desconoce el formato
de estas áreas, pero el programa de aplicación sí lo conoce. Probablemente disponga de una descripción de idioma de origen que pueda importar para describir el formato.
Nota: Los sucesos del sistema no utilizan datos de aplicación.
- Ubicación
- El valor del campo Ubicación depende de la llamada de API CICS.
- Ejemplos:
- Para el mandato EXEC CICS WRITE FILE(EXMPCAT),
las opciones para el campo Ubicación son FROM y RIDFLD.
- Para el mandato EXEC CICS INVOKE SERVICE(nombre),
las opciones para el campo Ubicación son CHANNEL y SCOPE.
- Contenedor
- Especifica un contenedor de canal CICS. El campo de contenedor sólo se puede seleccionar cuando los datos de aplicación tienen un canal especificado. En todas las demás situaciones, el campo está inhabilitado.
- Desplazamiento
- Especifica la distancia desde el principio, donde empiezan los datos.
El desplazamiento 0 es el principio del campo.
- Longitud
- Longitud del campo en bytes. Una longitud de 0 significa filtrar por toda el área de datos o contenedor. Esto es útil para filtrar, por ejemplo, el contenido de un contenedor, independientemente de su longitud.
- Operador
- Opciones de operador:
- Todo
- Existe
- Igual a
- No es igual a
- No existe
- Empieza por
- No empieza por
- Inferior a
- No es inferior a
- Superior a
- No es superior a
- Valor
- El valor que especifique para el predicado.
- La longitud depende del tipo de datos; por ejemplo, la longitud máxima del tipo character es 255 caracteres, mientras que la longitud máxima del tipo unsigned halfword es cinco caracteres con un valor en el rango de 0 a 65535.