Exportación de especificaciones de suceso desde una política

Si una acción de regla de política es emitir un suceso, puede exportar especificaciones de suceso para dicho suceso como un esquema o un libro de copias para utilizarlo en otros lugares.

Antes de empezar

Debe tener una política CICS con su acción de regla definida como Emitir un suceso. Para obtener instrucciones, consulte Creación y despliegue de una política en un proyecto de paquete de CICS.

Acerca de esta tarea

Los archivos exportados contienen el formato de los datos de suceso, lo cual es útil para procesar los datos capturados con los programas o motores de proceso de datos.

El formato de datos especificado por el adaptador EP elegido o el adaptador EP del conjunto de adaptadores EP elegidos, determina si el archivo exportado es un esquema o un libro de copias:
  • Para un formato XML como, por ejemplo, formato de suceso de base común (CBE), suceso de base común REST (CBE REST), Decision Server Insights Event o WebSphere Business Events, el archivo exportado es un archivo .xsd de definición de esquema XML. Los siguientes adaptadores pueden emitir sucesos en formatos de carácter de XML:
    • Adaptador HTTP
    • Adaptador de colas de TD
    • Adaptador de colas de TS
    • Adaptador de colas de IBM® MQ
  • Para un formato no XML, esto es, formato CFE (CICS Flattened Event), el archivo exportado es un archivo .cpy de libro de copias de COBOL. Los siguientes adaptadores pueden emitir sucesos en formato CFE (CICS Flattened Event):
    • Adaptador de colas de TD
    • Adaptador de colas de TS
    • Adaptador de colas de IBM MQ
Nota: No puede exportar especificaciones de sucesos para un adaptador de inicio de transacción o un adaptador personalizado.

Procedimiento

  1. En la pestaña Reglas del editor de definiciones de política, vaya a la sección Acción.
    Pestaña Acción en la pestaña Reglas del editor de definiciones de política
  2. Asegúrese de que la acción Emitir un suceso está seleccionada con un adaptador de proceso de suceso o un conjunto de adaptadores de proceso de suceso especificado.
  3. Pulse Exportar especificaciones de suceso.
  4. Se le solicitará que elija un adaptador o un conjunto de adaptadores en los casos siguientes:
    • En el espacio de trabajo, más de un adaptador EP tiene el mismo nombre que el adaptador especificado o un adaptador del conjunto de adaptadores EP especificado.
      Ventana Elegir el adaptador EP
    • En el espacio de trabajo, más de un conjunto de adaptadores EP tiene el nombre de conjunto de adaptadores especificado.
      Ventana Elegir el conjunto de adaptadores EP
  5. En la ventana Exportar especificaciones de suceso para la regla, asegúrese de que se especifica la información correcta en los campos correspondientes: La ventana Exportar especificaciones de suceso para regla
    Exportar
    La regla de política para la que desea exportar especificaciones de suceso.
    Al directorio
    El directorio local en el que desea guardar las especificaciones de suceso exportadas.
    Formato de datos

    El formato de datos especificado en el adaptador EP o el adaptador EP del conjunto de adaptadores EP.

    Este campo se muestra cuando CICS Explorer no puede determinar el formato de datos porque el adaptador EP, el conjunto de adaptadores EP o un adaptador EP del conjunto de adaptadores EP no está en el espacio de trabajo.

    Nota: Asegúrese de que la información del formato de datos coincide con la información especificada en los adaptadores EP, de lo contrario, podría fallar al utilizar los archivos exportados para procesar los datos.
    Versión

    La versión de la región CICS que emitirá el suceso, es decir, la región en la que se desplegará la política.

    Este campo se muestra cuando la regla de política se aplica aCICS TS 5.3 y anterior.

  6. Pulse Aceptar.
  7. Si ya existe una especificación de suceso exportado con el mismo nombre en el directorio especificado, se le solicitará si desea sobrescribir el archivo existente o si desea cancelar la exportación.

Resultados

Se creará uno o más archivos en el directorio especificado para la regla de política. Los ejemplos de la tabla siguiente muestran archivos que se han creado para distintos sucesos donde no se ha especificado ningún nombre de suceso.

Si se especifica un nombre de suceso, se utiliza como el prefijo del nombre de archivo exportado. Por ejemplo, si se especifica un nombre de suceso de nombre_suceso en el primer ejemplo, el archivo de salida se denominará nombre_suceso_dsie_CICS_54.xsd. Para obtener instrucciones sobre cómo definir los nombres de suceso, consulte Creación y despliegue de una política en un proyecto de paquete de CICS.
Tabla 1. Archivos de especificación de suceso exportados para sucesos diferentes
Adaptadores o conjuntos de adaptadores EP Regla de política Versión Formato de datos Especificaciones de sucesos exportados
Adaptador de colas de IBM MQ Una regla del sistema de estado de apertura de archivo V54 Formato Decision Server Insights Event (XML) Un archivo de esquema XML denominado fileEnable_rule_dsie_CICS_54.xsd, que se puede utilizar en la herramienta Insight Designer deIBM Operational Decision Manager para ayudarle a definir un suceso.
Adaptador de colas de TD o TS Una regla de tarea de solicitudes de almacenamiento V51 - 53 Formato de suceso de base común REST (CBE REST) (XML) Un archivo de esquema XML denominado cics_policy_event_payload_cbe_CICS_51-53.xsd, que se puede importar a IBM Business Monitor para definir un suceso de entrada.
V54 Un archivo de esquema XML denominado task_rules_payload_cbe_CICS_54.xsd, que se puede importar a IBM Business Monitor para definir un suceso de entrada.
Adaptador de colas de IBM MQ Una regla del sistema de estado de apertura de archivo V54 Formato CFE (CICS Flattened Event) Un libro de copias COBOL denominado DFHMPFEO_CICS_54.cpy, que se puede utilizarpara procesar datos en los propios programas de consumidor de sucesos.
Un conjunto de adaptadores EP tiene:
  • un adaptador de cola de TD o TS (formato CICS Flattened Event)
  • un adaptador de cola de IBM MQ (Formato de WebSphere Business Events (XML))
Una regla del sistema de estado de apertura de archivo V54

Formato CFE (CICS Flattened Event) Formato de WebSphere Business Events (XML)

Dos archivos denominados DFHMPFEO_CICS_54.cpy y fileEnable_rule_wbe_CICS_54.xsd, que puede utilizar en sus programas y en la IBM Operational Decision Manager herramienta Diseñador de sucesos.