Ereignisprotokollierung von einer benutzerdefinierten Erweiterung aus verwenden

Sie können benutzerdefinierte Erweiterungen programmieren, damit Einträge in das lokale Fehlerprotokoll geschrieben werden.

In den meisten Fällen verwenden benutzerdefinierte Erweiterungen Ausnahmebedingungen, um Fehler zu melden. Zur Fehlerermittlung und für Betriebszwecke können Sie jedoch wichtige Ereignisse, Fehler usw. auf dieselbe Weise wie Produktkomponenten aufzeichnen.

Beim C-Code können Sie die Dienstprogrammfunktion CciLog nutzen, um Fehler zu melden. Zwei an diese Funktion übergebene Argumente, messageSource und messageNumber, definieren die Ereignisquelle und die Integer-Darstellung einer Nachricht in dieser Quelle.

Bei Java-Code stellt die Klasse MbService statische Methoden zur Protokollierung von Informationen im Ereignisprotokoll bereit. Zur Protokollierung von Nachrichten im Ereignisprotokoll müssen Sie Ihre Nachrichten in ein Java-Standardressourcenpaket packen. Sie können eine der drei Protokollierungsmethoden verwenden, bei denen der Ressourcenpaketname und der Nachrichtenschlüssel übergeben wird. Die Nachricht wird vollständig aufgelöst und anschließend wie folgt als einzelne Einfügung in die entsprechende Broker-Nachricht eingefügt:

Auf Windows-Systemen werden die Nachrichten in das Windows-Ereignisprotokoll geschrieben, und Ihr Nachrichtenkatalog muss als DLL-Datei erstellt werden.

Bei Linux-, UNIX- und z/OS-Systemen werden die Nachrichten in das Tool SYSLOG geschrieben, und Ihr Nachrichtenkatalog muss als XPG4-Nachrichtenkatalog übermittelt werden.

Die Beschreibung gilt für Ausnahmebedingungen, die bei der normalen Verarbeitung auftreten. Sie müssen jedoch auch für den Fall Sorge tragen, dass Ausnahmebedingungen beim Einsatz und bei der Konfiguration eines Nachrichtenflusses auftreten. Nachrichten, die aus diesen Konfigurationsausnahmebedingungen resultieren, werden an die Workbench zurückgemeldet, damit Sie für den Workbench-Benutzer angezeigt werden können. Erstellen Sie eine entsprechend benannte Java-Eigenschaftendatei, die Ihre Nachrichten enthält, und kopieren Sie dann die Datei auf jeden Computer, auf dem Sie die Workbench ausführen. Dadurch können Ihre Nachrichten angezeigt werden.

Windows-Ereignisquelle erstellen und installieren

Windows platform Unter Windows wird der Nachrichtenkatalog als DLL-Datei übermittelt, die Sie wie in den folgenden Anweisungen beschrieben erstellen müssen. Die DLL-Datei enthält Definitionen Ihrer Ereignisnachrichten, damit die Ereignisanzeige ein lesbares Format anzeigen kann, basierend auf der von Ihrer Anwendung geschriebenen Ereignisnachricht. Wenn Sie einen Nachrichtenkatalog kompilieren, wird eine Headerdatei erstellt, die für jede Ereignisnachrichtennummer, die Sie erstellt haben, symbolische Werte definiert. Sie müssen die Headerdatei in Ihre Anwendung aufnehmen.

So erstellen Sie eine Ereignisquelle für den Windows-Ereignisprotokolldienst:
  1. Erstellen Sie eine Eingabedatei des Nachrichten-Compilers (.mc) mit der Quelle für Ihre Ereignisnachrichten. Suchen Sie auf der Microsoft Developer Network-Website unter .mc file nach Details zum Format dieser Eingabedatei.
  2. Kompilieren Sie diese Nachrichtendatei, um eine Eingabedatei für den Ressourcen-Compiler zu erstellen, indem Sie folgenden Befehl ausgeben:
    mc -v -w -s -h c:\mymessages -r c:\mymessages mymsg.mc

    Dabei gilt: c:\mymessages ist die Position für die Ausgabedateien, und mymsg.mc ist der Name der Eingabedatei.

    Der Nachrichten-Compiler erzeugt eine Ausgabeheaderdatei (.h)die symbolische #defines enthält, die den einzelnen Nachrichtennummern zugeordnet sind, die in der Datei input.mc codiert sind. Diese Headerdatei muss eingefügt werden, wenn eine benutzerdefiniert Erweiterungs-Quellendatei kompiliert wird, die die Dienstprogrammfunktion CciLog verwendet, um eine von Ihnen definierte Ereignisnachricht zu schreiben. Das Argument messageNumber für CciLog muss den entsprechenden als Hash definierten Wert in der Ausgabeheaderdatei verwenden.

  3. Kompilieren Sie die Ausgabedatei (.rc) aus dem Nachrichten-Compiler, um eine Ressourcendatei (.res) zu erstellen, indem Sie folgenden Befehl ausgeben:
    RC /v Ausgabedatei.rc
  4. Erstellen Sie eine Ressourcen-DLL mit Hilfe der Datei .res, indem Sie folgenden Befehl ausgeben:
    LINK /DLL /NOENTRY Ressourcendatei.res
So installieren Sie die Ereignisquelle im Windows-Ereignisprotokolldienst:
  1. Starten Sie den Windows-Registrierungseditor, indem Sie folgenden Befehl ausgeben:
    regedit
  2. Erstellen Sie einen neuen Registrierungsunterschlüssel für Ihre benutzerdefinierte Erweiterung unter der vorhandenen Struktur:
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog\Application

    Klicken Sie mit der rechten Maustaste auf Anwendung, und wählen Sie Neu > Schlüssel aus. Der neue Schlüssel wird direkt unter dem Schlüssel 'Application' erstellt (nicht unter dem Schlüssel 'WebSphere Message Broker'). Sie müssen dem Schlüssel den Namen geben, den Sie im Parameter messageSource des Aufrufs CciLog angeben.

    Für diesen Eintrag müssen Sie folgende Werte erstellen:

    EventMessageFile
    Dieser Zeichenfolgewert muss den vollständig qualifizierten Pfad für die Datei DLL enthalten, die Sie erstellt haben und die Ihre Nachrichten enthalten soll. Dieser Eintrag repräsentiert den Nachrichtenkatalog, der von CciLog verwendet wird.
    TypesSupported
    Setzen Sie den DWORD-Wert auf "7".
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
as04520_