Utilización de anotaciones cronológicas de sucesos desde una extensión definida por el usuario

Es improbable que los nodos y los analizadores de procesos de mensajes necesiten escribir directamente en las anotaciones de error locales, ya que es recomendable que un plug-in informe de errores utilizando excepciones. No obstante, puede optar por escribir sucesos significativos, de error o de cualquier otro tipo, con el fin de determinar posibles problemas y detectar distintos tipos de funcionamiento del mismo modo que WebSphere Business Integration Message Broker.

Con el código C, se utiliza la función de programa de utilidad CciLog para hacer esto. Dos de los argumentos aceptados por esta función, messageSource y messageNumber, definen el origen de sucesos y la representación de enteros real de un mensaje de dicho origen, respectivamente.

Para el código Java, la clase MbService proporciona métodos estáticos para anotar información en las anotaciones de sucesos. Para anotar mensajes en las anotaciones de sucesos, debe empaquetar los mensajes en un paquete de recursos Java estándar. Puede utilizar uno de los tres métodos de anotaciones cronológicas, pasando el nombre de paquete de recursos y la clave de mensaje. El mensaje se resuelve completamente y después se inserta como una sola inserción en el mensaje de intermediario apropiado, como se muestra a continuación:

Para los sistemas Windows, los mensajes se escriben en las anotaciones de sucesos de Windows, y el catálogo de mensajes debe entregarse como una DLL de Windows.

Para los sistemas UNIX, estos mensaje se escriben en el recurso SYSLOG, y el catálogo de mensajes debe entregarse como un catálogo de mensajes XPG4.

La información anterior abarca excepciones surgidas durante el proceso normal. También debe prevenir cualquier excepción surgida al difundir y configurar un flujo de mensajes. Los mensajes originados a partir de estas excepciones de configuración vuelven a notificarse al área de trabajo para que el usuario del área de trabajo pueda visualizarlos. Para facilitar esto, debe crear un archivo de propiedades Java con un nombre apropiado y copiarlo en cada área de trabajo.

Creación e instalación de un origen de sucesos Windows

En Windows, el catálogo de mensajes se entrega como una DLL de Windows, que el usuario debe crear de la forma descrita a continuación. Este catálogo contiene definiciones de los mensajes de sucesos para permitir que el visor de sucesos muestre un formato legible, basado en el mensaje de suceso escrito por la aplicación. Al compilar un catálogo de mensajes, se crea un archivo de cabecera que define valores simbólicos para cada número de mensaje de suceso que se haya creado. Este archivo de cabecera lo incluye la aplicación.

Para crear un origen de sucesos para el servicio de anotaciones de sucesos de Windows:
  1. Cree un archivo de entrada de compilador de mensajes (.mc) con el origen para los mensajes de sucesos. Consulte el sitio web de Microsoft, http://msdn.microsoft.com, y busque por .mc file para obtener información detallada acerca del formato de este archivo de entrada.
  2. Compile este archivo de mensaje para crear un archivo de entrada de compilador de recursos; para hacerlo, emita el mandato:
    mc -v -w -s -h c:\mymessages -r c:\mymessages mymsg.mc 

    Donde c:\mymessages es la vía de acceso y el directorio para los archivos de salida, y mymsg.mc es el nombre del archivo de entrada.

    El compilador de mensajes genera un archivo de cabecera de salida (.h), que contiene definiciones de # simbólicas que se correlacionan con cada número de mensaje codificado en el archivo input.mc. Este archivo de cabecera debe incluirse al compilar un archivo de origen de plug-in que utilice la función de programa de utilidad CciLog para escribir un mensaje de suceso que se haya definido. El argumento messageNumber para CciLog debe utilizar el valor apropiado definido por hash en el archivo de cabecera de salida.

  3. Compile el archivo de salida (.rc) del compilador de mensajes para crear un archivo de recursos (.res); para hacerlo, emita el mandato:
    RC /v <filename>.rc
  4. Cree una DLL de recurso utilizando el archivo .res; para hacerlo, emita el mandato:
    LINK / /NOENTRY <filename>.res
Para instalar el origen de sucesos en el servicio de anotaciones de sucesos de Windows:
  1. Inicie el editor de registros de Windows; para hacerlo, emita el mandato siguiente:
    regedit
  2. Cree una nueva subclave de registro para la aplicación de plug-in bajo la estructura existente definida en
    HKEY_LOCAL_MACHINE
       SYSTEM
          CurrentControlSet
             Services
                EventLog
                   Aplicación

    Pulse el botón derecho del ratón en Aplicación y seleccione Nueva->Clave. La nueva clave se crea inmediatamente en la clave Aplicación (no en la clave de WebSphere Business Integration Message Broker). Debe llamar a la clave con el mismo nombre que especifique en el parámetro messageSource de la invocación CciLog.

    Debe crear los valores siguientes para esta entrada:
    • El valor de la cadena EventMessageFile debe contener la vía de acceso completa para la .dll que haya creado para guardar los mensajes. Éste es el catálogo de mensajes utilizado por CciLog.
    • El valor DWORD TypesSupported debe contener el valor "7".

Conceptos relacionados
Nodos de entrada definidos por el usuario
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario
Analizadores definidos por el usuario

Tareas relacionadas
Desarrollo de extensiones definidas por el usuario