Separador Fuentes de información

Utilice la pestaña Fuentes de información para definir dónde obtiene esta especificación de captura la información empresarial emitida.

Esta pestaña consta de una tabla de los elementos de información empresarial que ha definido previamente en la pestaña Enlace de suceso. Debe especificar fuentes de información para cada elemento de información empresarial emitida.

Utilice esta pestaña para correlacionar los elementos de información empresarial asociados con la especificación de suceso con elementos de datos disponibles para este punto de captura.

Pestaña Fuentes de información

Los campos de la tabla Fuentes de información son un resumen de las opciones que puede editar en el panel Editar fuente de información.

Diálogo Fuente de información para un punto de captura de aplicación

Para abrir el diálogo Fuente de información para una fuente de información, seleccione una fuente de información en la tabla y pulse Editar o pulse dos veces la fuente de información.

El ejemplo siguiente muestra el diálogo Fuente de información con REWRITE seleccionado para un punto de captura de aplicación.

Figura 1. Diálogo Fuente de información para un punto de captura de aplicación
Diálogo Fuente de información para un punto de captura de aplicación.

Campos de Datos disponibles

La sección Datos disponibles contiene los campos siguientes:
Contexto
Los campos de contexto se utilizan para capturar datos sobre el contexto de aplicación. Las opciones de contexto válidas incluyen:
PROGRAM
TRANSID
USERID
Opciones de suceso
Las opciones de suceso se utilizan para capturar los valores de opciones en un mandato CICS. Las opciones de suceso varían según el punto de captura especificado.
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. Los datos de aplicación varían según el punto de captura especificado. Las opciones de importación y formato de libro de copia están disponibles en el diálogo solo cuando se selecciona un elemento de datos de aplicación en la sección Datos disponibles.
En función de las opciones que seleccione en la sección Datos disponibles, están disponibles los campos siguientes en el diálogo Fuente de información:
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.

Pulse Seleccionar a partir de estructura de lenguaje importada para importar una estructura de lenguaje. Después puede seleccionar el campo que desea capturar de la estructura de lenguaje. Si utiliza esta opción, los campos Tipo, Desplazamiento y Longitud se completan automáticamente. De forma alternativa, puede especificar los valores Tipo, Desplazamiento y Longitud.

Tipo
Especifica el tipo de datos para el predicado de datos de aplicación. Están disponibles los siguientes tipos de datos:
  • Coma flotante binaria
  • Carácter
  • Carácter terminado en nulo
  • Coma flotante decimal
  • Hexadecimal
  • Carácter terminado en hexadecimal
  • Coma flotante hexadecimal
  • Decimal empaquetado
  • Media palabra firmada
  • Palabra completa firmada
  • Media palabra sin firmar
  • Palabra completa sin firmar
  • Decimal con zona
Desplazamiento
Especifica la distancia desde el principio, donde empiezan los datos. El desplazamiento 0 es el principio del campo.
Longitud
Especifica la longitud del campo que debe capturarse. Especifique una longitud de 0 para capturar la totalidad del área de datos o contenedor. La especificación de una longitud de 0 tiene los siguientes efectos:
  • Para mandatos de API en los que la longitud del área de datos se especifica (o es el valor predeterminado del conversor) en un argumento separado en el mandato de API, se captura todo el contenido del área de datos o contenedor independientemente de su longitud. Por ejemplo, cuando se especifica COMMAREA y LENGTH en un mandato LINK, se capturan todos los datos.
  • Para mandatos de API en los que el área de datos que se captura no tiene un argumento de longitud, no se capturan datos. Por ejemplo, cuando se especifica RIDFLD en un mandato READ, o cuando se especifica INTO en un mandato RECEIVE MAP, no hay ningún argumento de longitud asociado, por lo tanto se capturan 0 bytes de datos.
Precisión
Seleccione la precisión para los elementos numéricos y científicos de información empresarial. Este campo está inhabilitado para otros elementos de información empresarial.
Página de códigos
Seleccione una página de códigos. Este campo está inhabilitado para algunos elementos de información empresarial, como los datos de aplicación que proceden de otra fuente. Para obtener más información sobre páginas de códigos, consulte el apartado Material de referencia de juego de caracteres codificado.
Datos estáticos
Para pasar datos que no se pueden cambiar al consumidor de sucesos, puede especificar datos estáticos que se van a asociar a un suceso. Puede definir valores estáticos de hasta 255 caracteres, incluidos los espacios. El juego de caracteres válido es el siguiente:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

Diálogo Fuente de información para un punto de captura de sistema

Para abrir el diálogo Fuente de información para una fuente de información, seleccione una fuente de información en la tabla y pulse Editar o pulse dos veces la fuente de información. CICS conoce el formato de todas las fuentes de información.

El ejemplo siguiente muestra el diálogo Fuente de información con FILE seleccionado para un punto de captura de sistema.

Figura 2. Diálogo Fuente de información para un punto de captura de sistema
Diálogo Fuente de información para un punto de captura de sistema
La sección Datos disponibles contiene los campos siguientes:
Contexto
Los campos de contexto se utilizan para capturar datos sobre el contexto del sistema. Las opciones de contexto válidas incluyen:
TRANSID
USERID
Datos de suceso de sistema
Los campos Datos de suceso de sistema se utilizan para capturar datos sobre el suceso de sistema ocurrido. Los datos de suceso de sistema varían según el punto de captura especificado.
Datos estáticos
Para pasar datos que no se pueden cambiar al consumidor de sucesos, puede especificar datos estáticos que se van a asociar a un suceso. Puede definir valores estáticos de hasta 255 caracteres, incluidos los espacios. El juego de caracteres válido es el siguiente:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

Las tablas siguientes listan los campos disponibles en el diálogo Fuente de información, en función del punto de captura de sistema seleccionado en el panel Punto de captura del sistema del separador Punto de captura.

Fuentes de información para DB2 CONNECTION STATUS

Tabla 1. Fuentes de información para DB2 CONNECTION STATUS
Opción Descripción
DB2ID

Si no utiliza una conexión de grupo, esta opción devuelve el nombre del subsistema DB2 al que está conectada la conexión CICS DB2, o si la conexión CICS DB2 no está conectada, el nombre del subsistema DB2 al que ha especificado que se conecte CICS.

Para obtener más información, consulte DB2ID en INQUIRE DB2CONN.

DB2GROUPID

Si utiliza la conexión de grupos, esta opción devuelve el nombre de un grupo, o subgrupo, de compartimiento de datos de subsistemas DB2 que ha especificado.

Para obtener más información, consulte DB2GROUPID en INQUIRE DB2CONN.

DB2RELEASE

Devuelve un valor de 4 caracteres que indica la versión y el nivel de release del subsistema DB2 al que está conectado CICS.

Para obtener más información, consulte DB2RELEASE en INQUIRE DB2CONN.

FROM_CONNECTST
Serie de caracteres que representa el estado de la conexión CICS DB2. Los posibles valores incluyen:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

Para obtener más información, consulte CONNECTST en INQUIRE DB2CONN.

TO_CONNECTST
Serie de caracteres que representa el estado de la conexión CICS DB2. Los posibles valores incluyen:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

Para obtener más información, consulte CONNECTST en INQUIRE DB2CONN.

Fuentes de información para FILE ENABLE STATUS

Tabla 2. Fuentes de información para FILE ENABLE STATUS
Opción Descripción
FILE

Especifica el nombre de ocho caracteres del archivo sobre el que está consultando.

Para obtener más información, consulte FILE en INQUIRE FILE.

DSNAME

Devuelve el nombre de 44 caracteres del conjunto de datos BDAM o el objeto VSAM asociado con la definición de FILE.

Para obtener más información, consulte DSNAME en INQUIRE FILE.

FROM_ENABLESTATUS
Serie de caracteres que identifica si los programas de aplicación pueden acceder al archivo. Los posibles valores incluyen:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

Para obtener más información, consulte ENABLESTATUS en INQUIRE FILE.

TO_ENABLESTATUS
Serie de caracteres que identifica si los programas de aplicación pueden acceder al archivo. Los posibles valores incluyen:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

Para obtener más información, consulte ENABLESTATUS en INQUIRE FILE.

OPENSTATUS
Serie de caracteres que identifica si el archivo está abierto, cerrado o en un estado transaccional. Los valores posibles incluyen:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

Para obtener más información, consulte OPENSTATUS en INQUIRE FILE.

Fuentes de información para FILE OPEN STATUS

Tabla 3. Fuentes de información para FILE OPEN STATUS
Opción Descripción
FILE

Especifica el nombre de ocho caracteres del archivo sobre el que está consultando.

Para obtener más información, consulte FILE en INQUIRE FILE.

DSNAME

Devuelve el nombre de 44 caracteres del conjunto de datos BDAM o el objeto VSAM asociado con la definición de FILE.

Para obtener más información, consulte DSNAME en INQUIRE FILE.

FROM_OPENSTATUS
Serie de caracteres que identifica si el archivo está abierto, cerrado o en un estado transaccional. Los valores posibles incluyen:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

Para obtener más información, consulte OPENSTATUS en INQUIRE FILE.

TO_OPENSTATUS
Serie de caracteres que identifica si el archivo está abierto, cerrado o en un estado transaccional. Los valores posibles incluyen:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

Para obtener más información, consulte OPENSTATUS en INQUIRE FILE.

ENABLESTATUS
Serie de caracteres que identifica si los programas de aplicación pueden acceder al archivo. Los posibles valores incluyen:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

Para obtener más información, consulte ENABLESTATUS en INQUIRE FILE.

Fuentes de información para MESSAGE

Tabla 4. Fuentes de información para MESSAGE
Opción Descripción
INSERTnn Especifica el valor de INSERTnn para el mensaje acerca del cual está consultando, donde nn es un identificador de 1 a 30.
MESSAGE_ID Especifica el número de mensaje de 9 caracteres del mensaje sobre el que realiza una consulta.
MESSAGE_TEXT Especifica el texto completo de un mensaje como campo de salida en un suceso. Utilice esta opción si desea capturar un mensaje completo. La longitud máxima del texto de mensaje capturado es de 1024 bytes. Si el mensaje tiene una longitud superior a 1024 bytes, se truncará.
Nota: Todos los mensajes se capturarán en el idioma definido por el parámetro de inicialización del sistema NATLANG, excepto los mensajes enviados a la consola de CICS, que se capturarán en inglés.

Fuentes de información para TASK THRESHOLD

Tabla 5. Fuentes de información para TASK THRESHOLD
Opción Descripción
FROM_TASKS

Especifica el número de tareas adjuntas antes de un suceso.

TO_TASKS

Especifica el número de tareas adjuntas después de un suceso.

MAXTASKS

Devuelve el número máximo de tareas que pueden entregarse en cualquier momento en este sistema CICS.

Para obtener más información, consulte MAXTASKS en INQUIRE SYSTEM.

PERCENT_MAXTASKS

Especifica el umbral que se ha cruzado como un porcentaje de tareas máximas.

Fuentes de información para TRANCLASS TASK THRESHOLD

Tabla 6. Fuentes de información para TRANCLASS TASK THRESHOLD
Opción Descripción
TRANCLASS

Especifica el nombre de 8 caracteres de la clase de transacción sobre la que realiza una consulta. Si la clase es una de las que están numeradas y se ha utilizado en releases anteriores de CICS, su nombre es DFHTCLnn, donde nn es el número de clase de dos dígitos.

Para obtener más información, consulte TRANCLASS en INQUIRE TRANCLASS.

FROM_ACTIVE

Devuelve el número de tareas activas en la clase de transacción antes de un suceso.

TO_ACTIVE

Devuelve el número de tareas activas en la clase de transacción después de un suceso.

MAXACTIVE

Devuelve el número máximo de tareas que pueden ejecutarse simultáneamente en la clase de transacción.

Para obtener más información, consulte MAXACTIVE en INQUIRE TRANCLASS.

PERCENT_MAXACTIVE

Especifica el umbral que se ha cruzado como un porcentaje de tareas activas máximas.

Fuentes de información para UNHANDLED TRANSACTION ABEND

Tabla 7. Fuentes de información para UNHANDLED TRANSACTION ABEND
Opción Descripción
TRANSACTION

Especifica el ID de transacción que ha emitido la terminación anómala de transacción no gestionada.

ABCODE

Especifica el código de terminación anómala de volcado de transacción de cuatro caracteres.

Para obtener más información, consulte Cómo añadir una especificación de captura.