LOG-Anweisung

Die LOG-Anweisung schreibt einen Datensatz in das Ereignis- oder Benutzertrace-Protokoll.

SYNTAX

CATALOG
CATALOG ist eine optionale Klausel; falls Sie sie übergehen, wird ihr als Standardwert der aktuelle WebSphere Message Broker-Versionskatalog zugewiesen. Zur expliziten Verwendung des aktuellen Versionsnachrichtenkatalogs von WebSphere Message Broker setzen Sie BIPV600auf allen Betriebssystemen ein.
EVENT
Ein Datensatz wird in das Ereignisprotokoll geschrieben (zudem in die Benutzertrace, wenn die entsprechende Funktion aktiviert ist).
EXCEPTION
Die aktuelle Ausnahme (falls vorhanden) wird protokolliert.
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. 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 der Wer der ersten Nachrichtennummer (2951) in einem Block von Nachrichten verwendet, der zur Verwendung durch die Anweisungen LOG und THROW im WebSphere Business Integration Message Broker-Katalog bereitgestellt wurde. Sie können die Nachrichtennummern 2951 bis 2999 eingeben. 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 Stückzahl von Informationen einfügen. Die Nachricht (2951 - 2999) kann jedoch nur zehn Einfügungen aufnehmen.

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

   -- Eine Nachricht in das Ereignisprotokoll schreiben, die den Schweregrad 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.XML.Data.Result = r;
  END;
Zugehörige Konzepte
Übersicht zu ESQL
Zugehörige Tasks
ESQL erstellen
Zugehörige Verweise
Syntaxdiagramme: verfügbare Typen
ESQL-Anweisungen
RETURN-Anweisung
Beispielnachricht
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ak05075_