LOG-Anweisung

Mit der LOG-Anweisung können Sie einen Datensatz in das Ereignisprotokoll oder den Benutzertrace schreiben.

SYNTAX

CATALOG
CATALOG ist eine optionale Klausel; wird sie nicht angegeben, nimmt CATALOG standardmäßig den aktuellen WebSphere Message Broker-Versionskatalog als Wert an. Verwenden Sie zur expliziten Nutzung des Nachrichtenkatalogs der aktuellen Version in allen Betriebssystemen BIPv600.

Wenn der Nachrichtenkatalog für Version 5 des Produkts genutzt werden soll, ist in allen Betriebssystemen BIPv500 zu verwenden.

EVENT
Ein Datensatz wird in das Ereignisprotokoll geschrieben und auch in den Benutzertrace, wenn die entsprechende Funktion aktiviert ist.
EXCEPTION
Die aktuelle Ausnahme, falls vorhanden, wird protokolliert.

Weitere Informationen zu Ausnahmen finden Sie im Abschnitt Fehler- und Ausnahmebedingungsbehandlung.

FULL
Der vollständige, verschachtelte Ausnahmebericht wird protokolliert, als ob die Ausnahme den Empfangsknoten erreicht hätte. Ist FULL nicht angegeben, werden alle umlaufenden Ausnahmen ignoriert und nur die Originalausnahme protokolliert. So erhalten Sie entweder einen vollständigen Bericht oder einfach den eigentlichen Fehlerbericht ohne Zusatzinformationen über die zu dem Zeitpunkt stattfindenden Ereignisse. Eine aktuelle Ausnahme kann nur innerhalb der Handler-Blöcke vorkommen (siehe Fehler in Nachrichtenflüssen behandeln).
MESSAGE
Die Nummer der zu verwendenden Nachricht. Ist sie angegeben, kann die MESSAGE-Klausel jeden Ausdruck enthalten, der einen ganzzahligen Nicht-Nullwert zurückgibt.

Wenn Sie MESSAGE nicht angeben, wird standardmäßig die erste Nachrichtennummer (2951) in einem Block von Nachrichten verwendet, der zur Verwendung durch die Anweisungen LOG und THROW im WebSphere Message Broker-Katalog bereitgestellt wurde. Es können Nachrichtennummern im Bereich 2951 bis 2999 angegeben werden. Sie können auch Ihren eigenen Katalog erstellen.

SEVERITY
Der mit der Nachricht verknüpfte Schweregrad. Ist er angegeben, kann die SEVERITY-Klausel jeden Ausdruck enthalten, der einen ganzzahligen Nicht-Nullwert zurückgibt. Geben Sie keine Klausel an, wird der Standardwert 1 verwendet.
USER TRACE
Ein Datensatz wird unabhängig davon, ob die Benutzertrace aktiviert oder inaktiviert ist, in die Benutzertrace geschrieben.
VALUES
Geben Sie mit der optionalen VALUES-Klausel die Werte für die Daten an, die in Ihre Nachricht eingefügt werden sollen. Sie können eine beliebige Anzahl von Informationen einfügen. Die übergebene Nachricht (2951 - 2999) kann jedoch nur zehn Dateneinfügungen aufnehmen.

Beachten Sie die allgemeine Ähnlichkeit zwischen der LOG-Anweisung und der THROW-Anweisung.

  -- Eine Nachricht in das Ereignisprotokoll schreiben, die die Dringlichkeit sowie die Katalog- und Nachrichtennummer
  -- angibt. Vier Einfügungen stehen zur Verfügung
  LOG EVENT SEVERITY 1 CATALOG 'BIPv600' MESSAGE 2951 VALUES(1,2,3,4);

  -- In das Traceprotokoll schreiben, sobald durch den Wert null dividiert wird
  BEGIN
    DECLARE a INT 42;
    DECLARE b INT 0;
    DECLARE r INT;

    BEGIN
      DECLARE EXIT HANDLER FOR SQLSTATE LIKE 'S22012' BEGIN
        LOG USER TRACE EXCEPTION VALUES(SQLSTATE, 'DivideByZero');

        SET r = 0x7FFFFFFFFFFFFFFFF;
      END;

      SET r = a / b;
    END;

    SET OutputRoot.XMLNS.Data.Result = r;
  END;
Zugehörige Konzepte
Übersicht zu ESQL
Zugehörige Tasks
ESQL erstellen
Nachrichtenkataloge erstellen
Zugehörige Verweise
Syntaxdiagramme: Verfügbare Typen
ESQL-Anweisungen
RETURN-Anweisung
THROW-Anweisung
Beispielnachricht
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:27

ak05075_