WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows

Primitivo de mediación Registrador de mensajes

Utilice el primitivo de mediación Registrador de mensajes para almacenar mensajes en una base de datos.

Introducción

El primitivo de mediación Registrador de mensajes almacena mensajes en una base de datos, durante un flujo de mediación. El primitivo de mediación Registrador de mensajes registra mensajes en una base de datos relacional mediante un esquema de base de datos definido por IBM; no escribe en otro medios de almacenamiento como los archivos sin formato.

El primitivo de mediación Registrador de mensajes registra una copia transcodificada XML del SMO. El comportamiento predeterminado es registrar solamente la carga, pero el primitivo de mediación puede configurarse para registrar el SMO completo, o una parte del SMO definido por una expresión XPath. Junto con el contenido del mensaje, el primitivo de mediación también registra una indicación de la hora, el identificador del mensaje, el nombre de la instancia del primitivo, el nombre de instancia del módulo de mediación y el número de versión de SMO.

El mensaje que se registra se almacena en una columna de base de datos denominada Message. Los otros datos que se registran se almacenan en columnas con una cabecera apropiada, como se documenta más adelante en este tema.

El primitivo de mediación Registrador de mensajes tiene un terminal de entrada y dos terminales de salida. Uno de los terminales de salida se utiliza para la salida satisfactoria y el otro para la salida con error. El terminal de entrada está conectado para aceptar un mensaje y los terminales de salida están conectados para propagar un mensaje. El mensaje de entrada desencadena un registro cronológico en una base de datos y, si dicho registro cronológico es satisfactorio, el terminal de salida satisfactorio propaga el mensaje original. Si se produce una excepción durante el proceso del mensaje de entrada, el terminal de error propaga el mensaje original, junto con información sobre la excepción.

Uso

Puede utilizar el primitivo de mediación Registrador de mensajes para almacenar mensajes que procesará más adelante. Los mensajes registrados pueden utilizarse con distintas finalidades. Por ejemplo, puede utilizar los mensajes registrados para la minería de datos o para auditoría.

El registro cronológico de datos como XML significa que puede procesarse mediante cualquier aplicación compatible con XML. Muchas bases de datos, inclusive DB2, proporcionan posibilidades incorporadas para gestionar el XML contenido en una columna de base de datos.

La instalación predeterminada del producto de ejecución crea un servidor de aplicaciones autónomo, una base de datos Cloudscape y un origen de datos. De forma predeterminada, el primitivo de mediación Registrador de mensajes está configurado para utilizar esta base de datos Cloudscape. El producto en tiempo de ejecución también proporciona un script, denominado createMessageLoggerResource.jacl, que crea una base de datos Cloudscape.

Propiedades

Nombre del origen de datos
Nombre JNDI del origen de datos que define dónde se registrarán los datos.
Raíz
Expresión XPath 1.0 que representa el ámbito del mensaje que debe registrarse. Puede especificar: /, /body, /headers o su propia expresión XPath. / hace referencia al SMO completo, /body hace referencia a la sección del cuerpo de SMO, y /headers hace referencia a las cabeceras del SMO. Si especifica su propia expresión XPath, se procesa la parte del SMO que especifique. El mensaje que debe registrarse se convierte en XML desde el punto especificado por Root.
Modalidad de transacción
Define si deben comprometerse los cambios en la base de datos dentro de la transacción del flujo o en una nueva transacción. Si especifica Same, el mensaje se registra dentro de la transacción del flujo. De forma predeterminada, el flujo se ejecuta en una transacción local, aunque el componente de mediación puede configurarse para que se ejecute en una transacción global. Si se ha especificado una transacción global y se produce un error en el flujo, la transacción global se retrotrae, incluida la operación de registro cronológico. Si especifica New, el mensaje se registra dentro de su propia transacción local. En este caso, si se produce un error en el flujo, el registro cronológico de mensajes no se retrotrae.
Tabla 1. Propiedades del primitivo de mediación Registrador de mensajes
Propiedad Valores válidos Valor predeterminado
Nombre del origen de datos Serie jdbc/mediation/messageLog
Raíz Serie: expresión XPath que representa la raíz de la transformación /body
Modalidad de transacción Serie: Same o New Same
Tabla 2. Esquema de tabla de base de datos del Registrador de mensajes
Nombre de columna Tipo SQL Campo clave Descripción
TimeStamp TIMESTAMP Y Indicación de fecha y hora UTC, que indica cuándo se ha registrado el mensaje en la base de datos.
MessageID VARCHAR Y ID del mensaje, del SMO.
MediationName VARCHAR Y Nombre de la instancia del primitivo de mediación que ha registrado el mensaje.
ModuleName VARCHAR N Nombre de la instancia del primitivo de mediación que contiene el primitivo Registrador de mensajes.
Message CLOB N SMO transcodificado en XML.
Version VARCHAR N Versión del SMO registrado.

Consideraciones

Considere lo siguiente al utilizar el primitivo de mediación Registrador de mensajes:

Información relacionada
Utilización del servicio mediador de datos Java Database Connectivity para el acceso a datos

Reference topic

Condiciones de uso | Evalúe esta página

Icono de fecha y horaÚltima actualización: 1 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.wbit.help.medprim.doc.nl1_6.0.1\ref\rwesb_MessageLoggermediationprimitive.html

(C) Copyright IBM Corporation 2005. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse. (http://www.eclipse.org)