Cómo añadir una especificación de captura

Añada especificaciones de captura a una especificación de suceso para crear puntos de captura en CICS.

Acerca de esta tarea

El editor de enlaces de sucesos de CICS le guía por la creación de una o varias especificaciones de captura. Estas especificaciones identifican a los siguientes elementos:

Por ejemplo, puede especificar que todo mandato READQ TS (READ de almacenamiento temporal) sea un suceso potencial. A continuación, puede cualificar las condiciones bajo las que se desencadena el suceso añadiendo predicados de los tipos disponibles para el mandato que desea interceptar.

Puede definir tres tipos de predicados:
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.

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.

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.

La información básica sobre el enlace de sucesos, especificada por el gestor empresarial durante la definición de nivel superior del enlace de sucesos, incluye una especificación de suceso. Esta información de enlace de sucesos ha identificado datos que se conocen por ser necesarios para posteriores procesos, pero no facilitan detalles sobre su ubicación. Debe especificar fuentes de información para proporcionar estos detalles.

El editor de enlaces de sucesos de CICS presenta en la pestaña Fuentes de información una tabla con la información que necesita para cumplir con la especificación del negocio. La tabla muestra información empresarial de la especificación del suceso. Debe definir la fuente de información de esta especificación de captura para cada elemento de la tabla.

Procedimiento

  1. En la pestaña Especificación, pulse una especificación de suceso. El panel de la derecha muestra los detalles de la especificación de suceso resaltada.
  2. Pulse Añadir una especificación de captura. Se visualiza la ventana Añadir especificación de captura.
  3. Escriba un nombre para la nueva especificación de captura. Los caracteres aceptables son A-Z, a-z, 0-9 y _. Los caracteres en blanco intercalados e iniciales no están permitidos. La serie no debe comenzar con 0-9, _, o la serie "xml", independientemente de si está en minúsculas, mayúsculas o mezclado, por ejemplo, "Xml" o "xMl".
  4. Opcional: Escriba una descripción para la nueva especificación de captura.
  5. Pulse Aceptar. Se crea una nueva especificación de captura. Se abren tres pestañas en el panel del editor a la derecha: Punto de captura, Filtrado y Fuentes de información. Utilice cada pestaña para proporcionar información que describa la nueva especificación de captura.
  6. Pulse la pestaña Punto de captura. Realice los siguientes pasos para añadir información de punto de captura:
    1. Seleccione el mandato EXEC CICS para el que desea añadir un punto de captura o Iniciación de programa desde la lista Punto de captura. Iniciación de programa es un punto de captura asociado con el inicio de un programa CICS.
    2. Pulse Capturar antes o Capturar después. Puede especificar el punto de captura que debe ser antes o después de algunos mandatos EXEC CICS. Esta opción se inhabilita para un subconjunto de estos mandatos EXEC CICS.
  7. Pulse la pestaña Filtrado. Efectúe los pasos siguientes si desea añadir información de predicado de captura:
    1. Opcional: Defina el contexto de aplicación para la especificación de captura. Se visualizan los predicados del contexto de aplicación disponibles para el punto de captura elegido. Seleccione una opción para Operador y proporcione un valor para especificar los predicados. Un operador de Todos especifica que no se realiza ningún filtrado en el predicado asociado. Introduzca valores para el ID de transacción, el Programa actual y el ID de usuario en mayúsculas.
    2. Opcional: Defina las opciones de aplicación para la especificación de captura. Se visualizan las opciones de aplicación disponibles para el punto de captura elegido. Seleccione una opción para Operador y proporcione un valor para especificar los predicados. Un operador de Todos especifica que no se realiza ningún filtrado en el predicado asociado.

      Las opciones de aplicación que pueden ser predicados primarios están marcadas con un asterisco (*). Debe seleccionar Igual a como Operador y especificar un valor para el predicado primario para mantener el rendimiento de CICS. Por ejemplo, para un punto de captura PUT CONTAINER especifique un valor para la opción de aplicación disponible CONTAINER*.

    3. Opcional: Defina los datos de aplicación para la especificación de captura. Para añadir un predicado de datos de aplicación, pulse Añadir. Se visualiza la ventana Predicado de datos de aplicación.

      Seleccione una opción para Operador y especifique un valor para el predicado. Un operador de Todos especifica que no se realiza ningún filtrado en el predicado asociado.

      Defina la variable que desea probar con el predicado. Puede pulsar Seleccionar de estructura de lenguaje importada y seguir las instrucciones de Selección de variables desde código fuente importado o seleccionar opciones para Ubicación y Tipo y definir más la variable, utilizando los campos activos del panel. Sólo estarán activos los campos que sean necesarios para el tipo que seleccione. Por ejemplo, si selecciona el tipo Carácter, sólo estarán activos los campos Desplazamiento, Longitud y Página de códigos.

  8. Pulse la pestaña Fuentes de información. Efectúe los siguientes pasos en cada una de las fuentes de información de la tabla para correlacionar la fuente de información con un elemento de datos disponible. Es posible que la tabla no contenga fuentes de información si no deben capturarse datos de negocio en el suceso.

    No tiene que capturar datos si no es necesario.

    1. Efectúe una doble pulsación sobre una fuente de información o selecciónela y pulse Editar. Se visualiza la ventana Fuente de información de suceso.
    2. Seleccione un elemento de datos disponible en Contexto, Valores de datos o Datos de longitud de variable. Si selecciona un elemento de datos de longitud variable, pulsar Seleccionar de estructura de lenguaje importada y seguir las instrucciones de Selección de variables desde código fuente importado o seleccionar opciones para Ubicación y Tipo y definir más la variable, utilizando los campos activos del panel. Sólo estarán activos los campos que sean necesarios para el tipo que seleccione. Por ejemplo, si selecciona el tipo Carácter, sólo estarán activos los campos Desplazamiento, Longitud y Página de códigos.

      La fuente de información no tiene que tener la misma longitud que el elemento de información empresarial emitida. CICS rellena o cancela el valor, según se necesite.

Resultados

Ha creado una especificación de captura. También puede eliminar especificaciones de captura pulsando Eliminar especificación de captura en la pestaña Punto de captura y pulsando para confirmar.