La pestaña Filtrado

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.
Imagen de la pestaña de filtrado.

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:
  • Todo
  • Igual a
Los valores del operador igual a incluyen:
  • Correcto
  • No es correcto

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.