Especificación de la información sobre el adaptador EP y el asignador

Especifique información en el enlace de sucesos que controla la forma en que CICS emite sucesos generados por el enlace de sucesos.

Acerca de esta tarea

Utilice la información del asignador para definir qué sucederá a los sucesos creados por este enlace. Seleccione el adaptador EP para emitir sucesos y, a continuación, seleccione aquellas opciones que sean relevantes para el adaptador EP.

Procedimiento

  1. Pulse la pestaña Adaptador en el Editor de enlaces de sucesos y seleccione la opción Utilizar un adaptador definido aquí para especificar la configuración de adaptador EP que debe utilizarse para este enlace de sucesos, los parámetros del adaptador EP y toda la información avanzada.

    De forma alternativa, puede seleccionar si utilizar un recurso EPADAPTERSET o un recurso EPADAPTER predefinido. Para obtener más información sobre un recurso EPADAPTER predefinido, consulte Editor de configuración del adaptador de proceso de sucesos (EP). Para obtener más información sobre un recurso EPADAPTERSET predefinido, consulte Editor de conjunto de adaptadores de proceso de sucesos (EP).

    Si especifica un recurso EPADAPTER o EPADAPTERSET predefinido, especifique el nombre en el campo Nombre o pulsar Seleccionar para elegir un recurso. Para obtener más información sobre cómo elegir recursos de adaptador, consulte Selección de un recurso de adaptador EP y Selección de un recurso de conjunto de adaptadores EP.

  2. Opcional: Puede exportar una o más especificaciones de suceso en este enlace de suceso.
  3. Elija el tipo de adaptador EP a partir de la lista Adaptador. Puede especificar los siguientes tipos de adaptador EP:
    Cola de IBM® MQ
    Emite sucesos a una cola de mensajes IBM MQ en un formato XML para que IBM Operational Decision Manager o IBM Business Monitor los consuman, o en un formato CFE (CICS Flattened Event) para su consumición directa desde IBM MQ.
    Para la emisión de sucesos asegurada, la entrega de los sucesos se asegura cuando se utiliza el adaptador EP de cola de IBM MQ junto con colas de mensajes IBM MQ persistentes.
    Inicio de transacción
    Emite sucesos a una transacción de CICS especificada. Los datos se pasan a la transacción en un formato de sucesos basado en contenedor. Puede especificar el sistema CICS que debe ejecutar la transacción. Puede utilizar una transacción existente, si los datos de suceso no se necesitan. El adaptador EP de inicio de transacción no da soporte a la emisión asegurada de los sucesos.
    Cola de TS
    Emite sucesos a una cola denominada CICS TS en uno de los formatos XML: Common Base Event, Common Base Event REST, Decision Server Insights Event, o WebSphere Business Events; o bien en un formato que no sea XML (CFE). Utilice este adaptador EP para validar que se estén capturando los sucesos correctos con los datos correctos y para emitir sucesos a todos los consumidores que puedan leer desde una cola TS.
    Para asegurar la emisión de sucesos, los sucesos transaccionales síncronos necesitan una cola de TS recuperable; los sucesos síncronos no transaccionales necesitan una cola no recuperable. Que las colas de TS sean recuperables depende de los valores de un modelo TSMODEL que coincida; las colas de TS son recuperables sólo cuando existe un TSMODEL coincidente. Cuando utilice el adaptador de cola de TS para los sucesos transaccionales síncronos, no podrá emitir un mandato DELETEQ TS para la cola de TS del suceso en la unidad de trabajo que captura el suceso.
    Cola de TD
    Emite sucesos a una cola de datos transitoria de CICS con nombre en uno de los formatos siguientes: suceso base común, suceso base común REST, CICS flattened event (CFE), Decision Server Insights Event y WebSphere Business Event. Utilice este adaptador EP al desarrollar y probar especificaciones de sucesos para validar que se estén capturando los sucesos correctos con los datos correctos y para emitir sucesos a todos los consumidores que puedan leer desde una cola TD.
    Para la emisión síncrona de sucesos, la cola de TD debe ser una cola entre particiones recuperable para sucesos transaccionales y una cola entre particiones no recuperable o una cola externa a las particiones para sucesos no transaccionales. El adaptador EP de TDQ se puede utilizar para pruebas y depuración, así como para producción.
    Personalizado (utilizar grabado)
    Emite sucesos en cualquier formato que necesite. Un adaptador EP personalizado es un programa de CICS que se escribe para proporcionar una combinación de formateo y direccionamiento de un suceso que no está soportado por los adaptadores EP proporcionados. El adaptador EP personalizado no debe llevar a cabo ningún otro proceso, como por ejemplo el consumo del suceso.
    Para la emisión de sucesos asegurada, el adaptador EP personalizado debe ajustarse a los requisitos de recuperación del suceso. Consulte la documentación de su adaptador EP personalizado para ver si da soporte a sucesos síncronos transaccionales o no transaccionales.
    HTTP
    Emite sucesos a un servidor HTTP 1.1 compatible utilizando HTTP POST en formato XML para que lo consuman productos, tales como IBM Operational Decision Manager o IBM Business Monitor. El adaptador EP de HTTP no da soporte a la emisión asegurada de los sucesos transaccionales.
  4. Especifique las siguientes opciones para el adaptador EP de HTTP:
    • Especifique las siguientes opciones para el adaptador EP de cola IBM MQ:
      • Especifique el nombre de la cola de IBM MQ en la que se colocan los sucesos emitidos por este enlace de sucesos. Debe especificar un nombre de cola.
      • Especifique si los mensajes son persistentes. Seleccione uno de los siguientes valores de la lista Persistentes.
        No
        Los mensajes colocados en la cola por el adaptador EP de cola de IBM MQ no son persistentes.
        Los mensajes colocados en la cola por el adaptador EP de cola de IBM MQ son persistentes.
        Predeterminado de cola
        Los mensajes colocados en la cola heredan la persistencia predeterminada de la cola con nombre.
      • Especifique la prioridad de mensaje. Puede seleccionar el Valor predeterminado de cola o escribir un valor en el campo Prioridad para la prioridad de mensaje de IBM MQ, de 0 a 9.
      • Especifique la fecha de caducidad. Puede seleccionar No caducar nunca o escribir un valor para la caducidad de mensaje de IBM MQ en el campo Tiempo de caducidad. Este tiempo se expresa en décimas de segundo. Un mensaje se convierte en elegible para ser descartado si no ha sido eliminado de la cola de destino antes de que transcurra este período.
      • Especifique un formato de datos para el suceso. Seleccione uno de los siguientes valores de la lista Formato de datos:
        Suceso de presentación simultánea CICS (binario)
        Los datos de suceso tienen un formato no XML.
        Suceso base común (XML)
        Los mensajes se colocan en la cola con el formato de suceso base común necesario para IBM Business Monitor
        Sucesos de negocio de WebSphere (XML)
        Los mensajes se colocan en la cola con el formato XML que Decision Server Events componente de IBM Operational Decision Manager precisa.
        Decision Server Insights Event (XML)
        Los mensajes se colocan en la cola con el formato XML que Decision Server Insights componente de IBM Operational Decision Manager necesita.Los datos de sucesos están en formato XML.
    • Especifique las siguientes opciones para el adaptador EP de inicio de transacción:
      • Especifique el ID de transacción de la aplicación CICS que se ejecuta como resultado de los sucesos. Debe especificar un ID de transacción.
      • Especifique un ID de usuario de transacción. La transacción iniciada por el adaptador EP de inicio de transacción se ejecutará con este ID de usuario.
      • Especifique el ID del sistema, que sólo está disponible para el adaptador EP de transacciones.La transacción del adaptador EP se ejecuta en el sistema CICS con este ID de sistema.
    • Especifique las siguientes opciones para el adaptador EP de cola TS:
      • Especifique el nombre de cola de CICS. Debe especificar un nombre de cola.
      • Si la cola de destino es remota, especifique el ID del sistema.
      • Seleccione Utilizar almacenamiento temporal auxiliar, si resulta necesario.
      • Especifique un formato de datos para el suceso. Seleccione uno de los siguientes valores de la lista Formato de datos:
        Suceso de presentación simultánea CICS (binario)
        Los datos de suceso tienen un formato no XML.
        Suceso base común (XML)
        Los datos de sucesos están en formato XML.
        Common Base Event REST (XML)
        Los datos de sucesos están en formato XML.
        Sucesos de negocio de WebSphere (XML)
        Los datos de sucesos están en formato XML.
        Decision Server Insights Event (XML)
        Los datos de sucesos están en formato XML.
    • Especifique las siguientes opciones para el adaptador EP de cola de TD:
      • Especifique el nombre de cola de CICS. Debe especificar un nombre de cola.
      • Si la cola de destino es remota, especifique el ID del sistema.
      • Especifique un formato de datos para el suceso. Seleccione uno de los siguientes valores de la lista Formato de datos:
        Suceso de presentación simultánea CICS (binario)
        Los datos de suceso tienen un formato no XML.
        Suceso base común (XML)
        Los datos de sucesos están en formato XML.
        Common Base Event REST (XML)
        Los datos de sucesos están en formato XML.
        Sucesos de negocio de WebSphere (XML)
        Los datos de sucesos están en formato XML.
        Decision Server Insights Event (XML)
        Los datos de sucesos están en formato XML.
    • Especifique las siguientes opciones para el adaptador EP personalizado (escrito por el usuario):
      • Especifique una de las opciones siguientes:
        • Si la modalidad de emisión es asíncrona, el ID de transacción para la aplicación CICS escrita por el usuario que formatea, direcciona y emite el suceso. Debe especificar un ID de transacción para la emisión asíncrona por parte del adaptador EP personalizado.
        • Si la modalidad de emisión es síncrona, el nombre del programa de aplicación CICS escrito por el usuario que formatea, direcciona y emite el suceso. Debe especificar un ID de programa para la emisión síncrona por parte del adaptador EP personalizado.
      • Escriba los datos que deben pasarse al adaptador EP personalizado. El adaptador EP personalizado procesará estos datos.
    • Especifique las siguientes opciones para el adaptador EP de HTTP:
      • Especifique un URIMAP. El nombre de un recurso URIMAP que representa la conexión con el servidor compatible con HTTP 1.1.
      • Especifique un formato de datos para el suceso. Seleccione uno de los siguientes valores de la lista Formato de datos:
        Suceso base común (XML)
        Los sucesos se envían a un servidor compatible con HTTP 1.1 en formato de suceso base común que cualquier producto que dé soporte a Common Event Infrastructure pueda consumir.
        Common Base Event REST (XML)
        Los sucesos se envían a un servidor compatible con HTTP 1.1 en el formato XML que IBM Business Monitor precisa.
        Sucesos de negocio de WebSphere (XML)
        Los sucesos se envían a un servidor compatible con HTTP 1.1 en el formato XML que Decision Server Events componente de IBM Operational Decision Manager precisa.
        Decision Server Insights Event (XML)
        Los sucesos se envían a un servidor compatible con HTTP 1.1 en el formato XML que Decision Server Insights componente de IBM Operational Decision Manager precisa.
  5. Opcional: Especifique todas las opciones de asignador avanzadas que sean necesarias. Estas opciones están previstas para usuarios avanzados y controlan cómo se ejecuta el adaptador EP en un sistema CICS.
    Nota: Generalmente, es más eficaz dejar que CICS ejecute el adaptador EP bajo la hebra del asignador. No obstante, podría necesitar que el adaptador EP se ejecute como una transacción por separado; por ejemplo, si tiene que ejecutarlo bajo un ID de usuario concreto que tiene autorización para escribir en la cola de IBM MQ o si desea controlar el número de tareas de adaptador EP simultáneas utilizando los valores TRANCLASS.
    1. Especifique la modalidad de emisión. Puede establecer el parámetro ASYNC o SYNC para especificar cómo se emiten los sucesos. Especifique la modalidad de emisión síncrona para la emisión de sucesos asegurada. Cuando la modalidad de emisión es síncrona, el adaptador EP de cola de IBM MQ emite estos sucesos:
      • Sucesos transaccionales utilizando la opción MQPMO_SYNCPOINT. Los mensajes de IBM MQ pueden recuperarse en la unidad de trabajo para la transacción de captura.
      • Sucesos no transaccionales utilizando la opción MQPMO_NO_SYNCPOINT.

      Cuando la modalidad de emisión es asíncrona, el adaptador EP de cola de IBM MQ emite sucesos utilizando la opción MQPMO_NO_SYNCPOINT.

      Notas :
      • Para sucesos síncronos (emisión de sucesos asegurada), la aplicación de captura de sucesos necesita autorización para escribir en el transporte de emisión de sucesos. Para sucesos asíncronos, el adaptador EP necesita autorización de escritura.
      • Especificar SYNC NONTRANS para el adaptador EP de HTTP convierte la transacción de captura en una aplicación web que puede tener que reconfigurarse de forma correspondiente.
      • Establezca el atributo DTIMOUT de la definición de TRANSACTION de cualquiera transacción que puede potencialmente emitir sucesos síncronos a través del adaptador HTTP EP.
    2. Especifique la prioridad de asignación. Puede especificar una prioridad Normal o Alta para controlar la forma en que el asignador de sucesos procesa sucesos asociados con este enlace de sucesos. Los sucesos de prioridad alta se emiten tan pronto como están disponibles en base al valor de Los sucesos son transaccionales. Los sucesos de prioridad normal se emiten tan pronto como están disponibles en base al valor de Los sucesos son transaccionales pero después de todos los sucesos de prioridad alta pendientes.
      Nota: Esta opción no se aplica a la modalidad de emisión síncrona.
    3. Especifique el ID de transacción y el ID de usuario. El adaptador se inicia con el ID de transacción y el ID de usuario especificados. El ID de transacción no es relevante para el tipo de adaptador EP personalizado, ya que se define en su lugar en la sección Adaptador. En función de los valores de ID de transacción e ID de usuario, la tarea del asignador EP inicia o enlaza al programa de adaptador EP.
      Tabla 1. ID de transacción e ID de usuario para el adaptador EP de cola de IBM MQ, el adaptador EP de cola de TD, el adaptador EP de cola de TS y el adaptador EP de inicio de transacción
      Se especifica el ID de transacción Se especifica el ID de usuario Utilizar ID de usuario de contexto El adaptador EP está El adaptador EP se ejecuta utilizando El ID de transacción del adaptador EP es
      x x   Conectado El ID de usuario especificado El ID de transacción especificado
      x   x Conectado El ID de usuario de contexto El ID de transacción especificado
        x   Conectado El ID de usuario especificado

      CEPQ para el adaptador EP de cola de IBM MQ CEPR para el adaptador EP de cola de TD
      CEPT para adaptador EP de cola de TS
      CEPS para adaptador EP de inicio de transacción

          x Conectado El ID de usuario de contexto

      CEPQ para el adaptador EP de IBM MQ CEPR para el adaptador EP de cola de TD
      CEPT para adaptador EP de cola de TS
      CEPS para adaptador EP de inicio de transacción

      x     Conectado ID de usuario predeterminado de CICS El ID de transacción especificado
            Enlazada ID de usuario de región CICS No aplicable
      Si la cola de IBM MQ, la cola de TD, la cola de TS o la transacción que desea iniciar es remota, consulte Seguridad de la intercomunicación para obtener información sobre los valores de seguridad.
      Tabla 2. ID de transacción e ID de usuario para adaptador EP de HTTP
      Se especifica el ID de transacción Se especifica el ID de usuario Utilizar ID de usuario de contexto El adaptador EP está El adaptador EP se ejecuta utilizando El ID de transacción del adaptador EP es
      x x   Conectado El ID de usuario especificado El ID de transacción especificado
      x   x Conectado El ID de usuario de contexto El ID de transacción especificado
        x   Conectado El ID de usuario especificado CEPH
          x Conectado El ID de usuario de contexto CEPH
      x     Conectado ID de usuario predeterminado de CICS El ID de transacción especificado
            Conectado ID de usuario predeterminado de CICS CEPH
      Para el adaptador EP personalizado (escrito por el usuario) que tiene un ID de transacción y una modalidad de emisión asíncrona, la tarea del asignador EP siempre conecta a este adaptador, con el ID de usuario especificado, o un ID de usuario de contexto, o el ID de usuario predeterminado de CICS.
      Nota: Estas dos opciones no se aplican a la modalidad de emisión síncrona.
    4. Especifique si los sucesos son transaccionales. Seleccione el recuadro de selección Los sucesos son transaccionales si desea que CICS sólo capture sucesos si la unidad de trabajo de negocio (UOW) asociada con el suceso se ha completado satisfactoriamente.
      Nota: Analice con atención si los sucesos capturados de acciones no recuperables deben especificarse como transaccionales. Por ejemplo, si captura un suceso transaccional de un mandato WEB SEND y la unidad de trabajo se restituye, el suceso se restituirá pero el mandato WEB SEND podría haber provocado que se enviará un mensaje HTTP.

      Borre el recuadro de selección Los sucesos son transaccionales si desea que CICS procese los sucesos asociados con este enlace de sucesos fuera de una transacción. Los sucesos se emiten a medida que tiene lugar.

Resultados

La información del adaptador y del asignador del enlace de suceso ahora ya está completa.