Datos de mensaje

Todos los sucesos base comunes de determinación de problemas deben proporcionar texto legible que describa el suceso notificado concreto en el campo msg del suceso base común.

Se da por supuesto que el texto asociado a los sucesos que representan mensajes o entradas de registro reales está traducido y localizado. Incluya el elemento msgDataElement en el suceso base común siempre que se proporcione texto internacionalizado en el suceso. Este elemento proporciona información relativa al modo en que el texto se crea e interpreta. Esta información es de especial relevancia cuando se intenta interpretar el suceso de forma programática o cuando se intenta interpretar el mensaje independientemente del entorno local o del idioma usado para dar formato al texto del mensaje.

Requisito previo: Ha de comprender los conceptos asociados a la creación de mensajes internacionalizados. Una buena fuente de información sobre estos conceptos es la documentación asociada a la internacionalización de información Java™ y la utilización de paquetes de recursos en el lenguaje Java.

El elemento msgDataElement del suceso base común incluye la siguiente información relativa al valor del campo msg que se proporciona con el evento:
  • El entorno local del texto del mensaje proporcionado, que identifica cómo están formateados los campos independientes del entorno local contenidos en el mensaje, además del idioma del mensaje (msgLocale).
  • Un identificador independiente del entorno local asociado al mensaje que puede utilizarse para interpretar el mensaje independientemente del idioma, entorno local y formato del mensaje (msgId y msgIdType).
  • Información sobre cómo se ha creado un mensaje traducido, que incluye:
    • El identificador utilizado para recuperar la plantilla del mensaje (msgCatalogId).
    • El nombre y el tipo de catálogo de mensajes utilizado para recuperar la plantilla del mensaje (msgCatalog y msgCatalogType).
    • Cualquier información independiente del entorno local que se haya insertado en la plantilla del mensaje para crear el mensaje final (msgCatalogTokens).
La especificación de Common Base Event [CBE101] (suceso base común) proporciona información sobre el formato necesario de estos campos y la Guía del desarrollador de suceso base común [CBEBASE] proporciona pautas generales de uso. Esta sección proporciona información adicional sobre cómo dar formato y utilizar estos campos en los sucesos de determinación de problemas.
msg
Todos los sucesos de rastreo, mensaje y registro deben facilitar un mensaje legible en el campo msg del suceso base común. El campo msg es obligatorio en los sucesos de determinación de problemas, tanto los sucesos de registro como los de diagnóstico. Este campo es más restrictivo que la especificación base del suceso base común, que lista este campo como opcional, ya que para determinar de forma eficaz y eficiente los problemas es necesario poder identificar rápidamente la situación notificada. El formato y el uso de este mensaje son específicos del componente, pero se deben seguir las directrices generales siguientes:
  • Dé por sentado que el texto del mensaje facilitado en los mensajes y sucesos de registro está internacionalizado.
  • Proporcione el entorno local del texto del mensaje mediante el campo msgLocale del elemento msgDataElement del suceso base común.
  • Facilite información adicional relativa al formato y a la construcción de mensajes internacionalizados siempre que sea posible, utilizando el elemento msgDataElement del suceso base común.
msgLocale
Proporcione el entorno local del mensaje siempre que el texto del mensaje se proporcione en el suceso base común, como ocurre con todos los sucesos de determinación de problemas. El campo msgLocale se lista como valor opcional dentro de la especificación de suceso base común, pero deberá facilitarse en los sucesos de determinación de problemas siempre que sea posible. La razón por la que no es un campo obligatorio en los sucesos de determinación de problemas es que hay instancias donde la información de entorno local no se facilita o no está disponible cuando se da formato al suceso base común.
msgId y msgIdType
Varias empresas incluyen en el texto del mensaje internacionalizado un identificador independiente del entorno local que puede utilizarse para interpretar la condición descrita en el texto del mensaje, independientemente del mensaje. Por ejemplo, la mayor parte de los mensajes emitidos por el software IBM® son similares a IEE890I WTO Buffers in console backup storage = 1024, donde un identificador independiente del entorno local IEE890I precede al texto del mensaje traducido. Este identificador proporciona un modo de detectar e identificar sin ambigüedades un mensaje independientemente de su ubicación e idioma. Esta detección tiene un valor incalculable en un análisis programático independiente del entorno local.
El campo msgId se lista como valor opcional en la especificación de suceso base común, pero este identificador debe facilitarse en los sucesos de determinación de problemas siempre que esté incluido en el texto del mensaje. Del mismo modo, el campo instanceId se lista como valor opcional en la especificación de suceso base común, pero debe facilitarse en los sucesos de determinación de problemas siempre que se proporcione un valor para msgId. Estos campos no deben facilitarse cuando el texto del mensaje no esté traducido o localizado, por ejemplo, en el caso de los sucesos de rastreo.
msgCatalogId
El campo msgCatalogId se lista como valor opcional en la especificación de suceso base común, pero debe facilitarse siempre que el suceso base común incluya el texto del mensaje traducido o localizado, por ejemplo, al proporcionar sucesos de determinación de problemas que representen mensajes emitidos o sucesos de registro. Este campo no es obligatorio en los sucesos de determinación de problemas, ya que no todos los sucesos de determinación de problemas incluyen texto del mensaje traducido, y se dan casos en los que el valor no se facilita o no está disponible al dar formato al suceso base común. Este campo no debe facilitarse cuando el texto del mensaje no esté traducido o localizado, por ejemplo, en el caso de los suceso de rastreo.
msgCatalogTokens
El campo msgCatalogTokens se lista como valor opcional en la especificación de suceso base común, pero debe facilitarse siempre que el suceso base común incluya el texto del mensaje traducido o localizado, por ejemplo, al proporcionar sucesos de determinación de problemas que representen mensajes emitidos o sucesos de registro. Este campo no es obligatorio en los sucesos de determinación de problemas, ya que no todos los sucesos de determinación de problemas incluyen texto de mensaje traducido, y se dan casos en los que el valor no se facilita o no está disponible al dar formato el suceso base común. Este valor contiene la lista de valores independientes del entorno local o tokens de mensaje insertados en el texto del mensaje localizado al crear un mensaje traducido.
Es difícil extraer estos valores de un mensaje traducido sin conocer la plantilla del mensaje traducido que se ha utilizado para crear el mensaje. No debe facilitarse este campo cuando el texto del mensaje no esté traducido o localizado.
La especificación de suceso base común proporciona varios mecanismos para facilitar datos adicionales de un suceso, incluyendo este campo, elementos de datos extendidos y extensiones del esquema. Utilice siempre el campo msgCatalogTokens para facilitar la lista de tokens de mensaje incluida en el texto del mensaje asociado a un suceso. Estos valores también se pueden facilitar en otras partes del suceso base común, pero deben incluirse en este campo.
msgCatalog y msgCatalogType
Los campos msgCatalog y msgCatalogType se listan como valores opcionales en la especificación de suceso base común, pero deben facilitarse siempre que suceso base común incluya el texto del mensaje traducido o localizado, por ejemplo, al proporcionar sucesos de determinación de problemas que representen mensajes emitidos o sucesos de registro. Estos campos no son obligatorios en los sucesos de determinación de problemas, ya que no todos los sucesos de determinación de problemas incluyen texto de mensaje traducido, y se dan casos en los que el valor no se facilita o no está disponible al dar formato el suceso base común. No complete estos campos cuando el texto del mensaje no esté traducido o localizado, por ejemplo, en el caso de los sucesos de rastreo.

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_cbemessage
File name: rtrb_cbemessage.html