Especificación de 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 de CICS 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.

    También puede seleccionar si utilizar un recurso EPADAPTER predefinido o un recurso EPADAPTERSET. Para obtener más información sobre un recurso EPADAPTER predefinido, consulte Editor de configuración del adaptador de proceso de sucesos (EP) en el Information Center de CICS TS 5.1 . Para obtener más información sobre un recurso EPADAPTERSET predefinido, consulte Editor del conjunto de adaptadores del proceso de sucesos (EP) en el Information Center de CICS TS 5.1 .

    Si especifica un recurso EPADAPTER o EPADAPTERSET predefinido, debe escribir 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 Elección de un recurso de adaptador EP en el Information Center de CICS TS 5.1 y Elección de un recurso de conjunto de adaptadores EP en el Information Center de CICS TS 5.1.

  2. Opcional: Puede exportar una o varias especificaciones de suceso en este enlace de sucesos.
    Para exportar una especificación de suceso, escriba el nombre de un recurso EPADAPTER predefinido o seleccione el adaptador que desee:
    • Utilice el adaptador EP de TSQ o el adaptador EP de WebSphere MQ y seleccione el formato CFE para emitir los sucesos en formato binario y proporcionar así un libro de copias COBOL (.cpy).
    • Utilice cualquier otro adaptador de EP y formato para proporcionar una definición de esquema XML (.xsd).
    Nota: No se da soporte a la exportación de especificaciones de suceso si no se utiliza un adaptador de inicio de transacción. Para obtener más información sobre el formato de suceso basado en contenedor de CICS, consulte Formatos de proceso de sucesos en el Information Center de CICS TS 5.1 .
    1. Pulse Exportar especificaciones de suceso. Si utiliza un recurso EPADAPTER y el espacio de trabajo contiene más de un adaptador con el mismo nombre, se le solicitará seleccionar un adaptador en una lista. Se visualiza la ventana Exportar especificaciones de suceso.
    2. Seleccione las especificaciones de suceso que desea exportar.
    3. Para exportar las especificaciones de suceso, especifique el directorio en el campo Al directorio.
    4. Si utiliza un recurso EPADAPTER predefinido que no se encuentra en el espacio de trabajo, debe seleccionar un valor adecuado para el campo Formato de datos.
    5. Pulse Exportar.
    Se creará un archivo en el directorio especificado para cada especificación de suceso que haya seleccionado.
    Estas son algunas especificaciones de ejemplo:
    • Si especifica el adaptador EP de WebSphere MQ y el formato de Common Base Event y selecciona dos especificaciones de suceso denominadas example1 y example2, se crean dos archivos de esquema XML: example1_CBE.xsd y example2_CBE.xsd. Puede importar estos archivos de esquema a IBM® Business Monitor como ayuda para definir un suceso de entrada.
    • Si especifica el adaptador EP de WebSphere MQ y el formato de WebSphere Business Events (XML) y selecciona una especificación de suceso denominada example1, se crea un archivo de esquema XML, example1_WBE.xsd. Puede utilizar este archivo de esquema en la herramienta WebSphere Business Events Design Data como ayuda para definir un suceso.
    • Si especifica el adaptador EP de HTTP y el formato REST de Common Base Event y selecciona dos especificaciones de suceso denominadas example1 y example2, se crean dos archivos de esquema XML: example1_CBER.xsd y example2_CBER.xsd. Puede importar estos archivos de esquema a IBM Business Monitor como ayuda para definir un suceso de entrada.
    • Si especifica el adaptador EP de HTTP y el formato de WebSphere Business Events (XML) y selecciona una especificación de suceso denominada example1, se crea un archivo de esquema XML, example1_WBE.xsd. Puede utilizar este archivo de esquema en la herramienta WebSphere Business Events Design Data como ayuda para definir un suceso de entrada.
    • Si especifica el adaptador EP de HTTP y el formato de suceso base común y selecciona dos especificaciones de suceso denominadas example1 y example2, se crean dos archivos de esquema XML: example1_CBE.xsd and example2_CBE.xsd. Puede importar estos archivos de esquema a cualquier consumidor que acepte el formato de suceso base común como ayuda para definir un suceso de entrada.
    • Si especifica el adaptador EP de cola TS y selecciona dos especificaciones de suceso denominadas example1 y example2, se crean dos libros de copias COBOL: example1.cpy y example2.cpy. Puede utilizar estos libros de copias para procesar datos en sus propios programas de consumidor de sucesos.

    Tenga en cuenta que si exporta una especificación de suceso y después vuelve a exportarla al mismo directorio, el editor de enlaces de sucesos de CICS le solicitará que sobrescriba el archivo existente o que cancele la operación de exportación.

  3. Elija el tipo de adaptador EP en la lista Adaptador. Puede especificar los siguientes tipos de adaptador EP:
    Cola de TS
    Emite sucesos a una cola de TS de CICS especificada en formato XML: suceso base común, REST de suceso base común o WebSphere Business Events (WBE); o bien en un formato no 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 la emisión de sucesos asegurada, 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.
    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 no se requieren datos del suceso-
    El adaptador EP de inicio de transacción no da soporte a la emisión asegurada de los sucesos.
    Personalizado (escrito por el usuario)
    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 realizar ningún otro proceso, como un consumo del suceso.
    Para la emisión de sucesos asegurada, el adaptador EP personalizado debe ajustarse a los requisitos de recuperabilidad del suceso. Consulte la documentación de su adaptador EP personalizado para ver si da soporte a sucesos síncronos transaccionales o no transaccionales.
    WebSphere Message Queue
    Emite sucesos a una cola de mensajes WebSphere en formato XML para que los consuma WebSphere Business Events, en formato de suceso base común para IBM Business Monitor o en un formato no XML.
    Para la emisión de sucesos asegurada, la distribución de los sucesos está asegurada cuando se utiliza el adaptador EP de WebSphere MQ en combinación con colas de mensajes WebSphere persistentes.
    HTTP
    Emite sucesos a un servidor compatible con HTTP 1.1 utilizando HTTP POST en formato XML para que los consuman productos como WebSphere Business Events, y 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 de 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 es 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.
        WebSphere Business Events (XML)
        Los datos de sucesos están en formato XML.
        Suceso base común (XML)
        Los datos de sucesos están en formato XML.
        REST de suceso base común (XML)
        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 personalizado (escrito por el usuario):
      • Especifique una de las siguientes opciones:
        • 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 WebSphere MQ:
      • Especifique el nombre de la cola de WebSphere 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 WebSphere MQ no son permanentes.
        Los mensajes colocados en la cola por el adaptador EP de WebSphere MQ son permanentes.
        Valor 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 Valor predeterminado de cola o escribir un valor en el campo Prioridad para la prioridad de mensaje de WebSphere 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 WebSphere 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.
        WebSphere Business Events (XML)
        Los mensajes se colocan en la cola con el formato XML que WebSphere Business Events necesita.
        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
    • 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:
        REST de suceso base común (XML)
        Los sucesos se envían a un servidor compatible con HTTP 1.1 en el formato XML que IBM Business Monitor precisa.
        WebSphere Business Events (XML)
        Los sucesos se envían a un servidor compatible con HTTP 1.1 en el formato XML que WebSphere Business Events precisa.
        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.
  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 WebSphere 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 WebSphere MQ emite estos sucesos:
      • Sucesos transaccionales utilizando la opción MQPMO_SYNCPOINT. Los mensajes de WebSphere 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 WebSphere 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 adaptador EP de WebSphere MQ, adaptador EP de cola de TS y 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 adaptador EP de WebSphere MQ
      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 adaptador EP de WebSphere MQ
      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
            Enlazado ID de usuario de región CICS No aplicable
      Si la cola de WebSphere MQ, la cola de TS o la transacción que desea iniciar es remota, consulte 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 sucesos ahora ya está completa.