Un origen de sucesos es un punto de un flujo de mensajes desde el que se puede emitir un suceso de supervisión. Cada origen de suceso tiene un conjunto de propiedades que controlan el contenido de los sucesos de supervisión que emite.
- Visualice las propiedades del nodo.
- Seleccione el separador Supervisión.
- Pulse Añadir.
Se visualiza la ventana Añadir entrada.
- Rellene el campo Origen de sucesos.
El campo tiene una lista desplegable de todos los sucesos que pueden definirse para este nodo. La información de origen de sucesos se utiliza para llenar los atributos del elemento wmb:eventPointData/wmb:messageFlowData/wmb:node del suceso.
Una vez que ha seleccionado el origen de sucesos, se visualiza el valor correspondiente de Dirección del origen de sucesos como propiedad de sólo lectura.
Consejo: Si más adelante decide habilitar o inhabilitar sucesos utilizando el mandato mqsichangeflowmonitoring, debe especificar un valor para Dirección de origen del suceso que no sea Nombre de suceso.
- Rellene los detalles del Nombre de suceso; seleccione
Literal o Ubicación de datos.
Cada suceso de supervisión tiene un nombre que se coloca en el atributo
wmb:eventPointData/wmb:eventIdentity/@wmb:eventName del suceso. Los nombres predeterminados se muestran en la tabla siguiente:
Origen del suceso |
Nombre de suceso predeterminado |
Ejemplo |
Inicio de la transacción |
etiquetaNodo.TransactionStart |
MQInput.TransactionStart |
Finalización de la transacción |
etiquetaNodo.TransactionEnd |
MQInput.TransactionEnd |
Retrotracción de la transacción |
etiquetaNodo.TransactionRollback |
MQInput.TransactionRollback |
Terminal |
etiquetaNodo.etiqueta_terminal.Terminal |
MQInput.OutTerminal |
Puede alterar temporalmente los valores predeterminados de las siguientes maneras.
- Especificando una serie literal alternativa.
- Especificando una consulta XPath; la consulta extrae el nombre de suceso de un campo en el mensaje de entrada. Pulse Editar para utilizar el Creador de expresiones XPath.
- Opcional: Complete la sección Filtro de sucesos suministrando una expresión
XPath para controlar si se emite el suceso. Efectúe uno de los siguientes pasos:
- Escriba la expresión (por ejemplo, $Body/StockTrade/Details/Value
> 10000); o
- Pulse Editar para iniciar Creador de expresiones XPath.
La expresión debe evaluar como verdadero (true) o falso (false) y puede hacer referencia a campos del árbol de mensajes o de cualquier otro lugar en el mensaje ensamblado.
El valor predeterminado es true(), que significa que el suceso se genera siempre.
Mediante este recurso, puede ajustar las emisiones de sucesos según sus necesidades empresariales, filtrando los sucesos que no coincidan con un conjunto de reglas. De este modo se puede reducir la cantidad de sucesos emitidos, y reducir también la carga de trabajo en la aplicación de supervisión.
- Opcional: rellene la sección Carga útil de suceso, si el suceso va a contener campos de datos seleccionados extraídos del mensaje. Pulse Añadir para abrir el recuadro de diálogo Añadir ubicación de datos. Efectúe uno de los siguientes pasos:
- Escriba la ubicación (por ejemplo, $LocalEnvironment/File/Name), o
- Pulse Editar para iniciar Creador de expresiones XPath.
Puede extraer uno o más campos de los datos del mensaje e incluirlo con el suceso. Los campos pueden ser simples o complejos.
El contenido simple está en el campo wmb:applicationData/wmb:simpleContent del suceso; los datos complejos están en el campo wmb:applicationData/wmb:complexContent.
Este recurso se utiliza comúnmente para comunicar datos empresariales importantes en un suceso empresarial. Si el suceso contiene la corriente de bits de entrada, este recurso también se puede utilizar para extraer campos clave, lo que permite a otra aplicación proporcionar un seguimiento de auditoría o volver a someter mensajes anómalos.
- Opcional: seleccione el campo Incluir datos de corriente de bits en carga útil, si el suceso va a capturar datos de corriente de bits de mensajes.
- Content
- Seleccione entre Headers, Body, All.
- Encoding
- Seleccione entre base64, HexBinary y CData (el texto origina, sin codificación).
- Opcional: pulse el separador Correlación para completar los detalles para la correlación de sucesos.
- Complete los detalles de Correlación de sucesos; para obtener información sobre la correlación, consulte Sucesos de correlación y supervisión.
Cada suceso de supervisión debe contener como mínimo un atributo de correlación, y puede contener hasta tres. Si no especifica ninguna información de correlación, el primer origen de sucesos del flujo de mensajes asigna un identificador exclusivo que utilizarán todos los orígenes de sucesos posteriores en la misma transacción.
- Opcional: rellene Correlacionador de transacciones locales.
- Automático
- Se utilizará el correlacionador local que ha utilizado el suceso más reciente para esta invocación del flujo de mensajes. Si no existe ningún correlacionador local, se generará un nuevo valor exclusivo.
- Especificar ubicación de correlacionador
- Escriba un valor o pulse Editar para iniciar Creador de expresiones XPath. El correlacionador local se leerá de la ubicación especificada en el árbol de mensajes. Asegúrese de que la ubicación especificada contiene un valor de correlacionador exclusivo para esta invocación del flujo de mensajes.
- Opcional: rellene los detalles del Correlacionador de transacciones padre para extraer un campo de correlación de la transacción padre.
- Automático
- Se utilizará el correlacionador padre que ha utilizado el suceso más reciente para esta invocación del flujo de mensajes. Si aún no existe ningún correlacionador padre, no se utilizará ningún correlacionador padre.
- Especificar ubicación de correlacionador
- Escriba un valor o pulse Editar para iniciar Creador de expresiones XPath. El correlacionador padre se leerá de la ubicación especificada en el árbol de mensajes. Asegúrese de que la ubicación especificada contiene un valor adecuado para el correlacionador padre.
- Opcional: rellene los detalles del Correlacionador de transacciones global para extraer un campo de correlación de la transacción global.
- Automático
- Se utilizará el correlacionador global que ha utilizado el suceso más reciente para esta invocación del flujo de mensajes. Si aún no existe ningún correlacionador global, no se utilizará ningún correlacionador global.
- Especificar ubicación de correlacionador
- Escriba un valor o pulse Editar para iniciar Creador de expresiones XPath. El correlacionador global se leerá de la ubicación especificada en el árbol de mensajes. Asegúrese de que la ubicación especificada contiene un valor adecuado para el correlacionador global.
- Opcional: Elija si la emisión de los sucesos de supervisión mediante un flujo de mensajes se coordina con la transacción de flujo de mensajes o si se encuentra en una unidad de trabajo independiente, o si no está en ninguna unidad de trabajo.
Pulse el separador
Transacción y seleccione la opción adecuada para
Unidad de trabajo de sucesos.
- Flujo de mensajes
- El suceso, y todos los demás sucesos con este valor, se emiten solamente si el flujo de mensajes confirma su unidad de trabajo de forma satisfactoria.
Si se especifica que debe incluirse el suceso de inicio de transacción en la unidad de trabajo del flujo de mensajes, pero falla el proceso de mensajes y no se publica esta unidad de trabajo, el suceso de inicio de transacción se incluirá en una unidad de trabajo independiente. De este modo se garantiza que la aplicación de supervisión recibe un par de sucesos (inicio y retrotracción) en lugar de recibir un suceso de retrotracción aislado.
- Independiente
- El suceso se emite en una segunda unidad de trabajo, independientemente de la unidad de trabajo principal. El suceso, y todos los demás sucesos con este valor, se emiten tanto si la unidad de trabajo principal se confirma de forma satisfactoria como si no.
Se puede iniciar una transacción independiente solamente si se ha confirmado o retrotraído la transacción principal.
Si la propiedad Cuenta de confirmaciones del flujo es mayor que uno,
(Propiedades configurables del flujo de mensajes) o si la propiedad Confirmar por grupo de mensajes se ha establecido (Recepción de mensajes en un grupo de mensajes WebSphere MQ), los sucesos de destino para la transacción independiente se emiten en su lugar fuera del punto de sincronismo y se emite un mensaje indicando que la acción se ha realizado.
- Ninguno
- El suceso se emite fuera del punto de sincronismo (no en una unidad de trabajo). El suceso se emite cuando el mensaje pasa a través del origen de sucesos y está disponible para la lectura inmediatamente.
No todas estas opciones están disponibles en todos los tipos de sucesos. Los valores predeterminados y los valores permitidos aparecerán en la tabla siguiente:
Origen del suceso |
Valores permitidos |
Valor predeterminado |
Inicio de la transacción |
- Flujo de mensajes
- Independiente
- Ninguno
|
Flujo de mensajes |
Finalización de la transacción |
- Flujo de mensajes
- Ninguno
|
Flujo de mensajes |
Retrotracción de la transacción |
|
Independiente |
Terminal |
- Flujo de mensajes
- Independiente
- Ninguno
|
Flujo de mensajes |
- Pulse Finalizar.
La tabla Sucesos del separador Supervisión de la vista Propiedades para el nodo se actualiza con los detalles del suceso que acaba de añadir; el suceso se habilita.
- Opcional: Inhabilite el suceso.
- Guarde el flujo de mensajes.