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

>>-LOG--+-EVENT-------+--+---------------------+--+----------+--+----------------------------+-><
'-USER--TRACE-' '-+------+--EXCEPTION-' '-Optionen-' | .-,--------. |
'-FULL-' | V | |
'-VALUES--(----Ausdruck-+--)-'
WHERE
|--Optionen =--+----------------------+--+-------------------+--+-------------------+--|
'-SEVERITY--Expression-' '-CATALOG--Ausdruck-' '-MESSAGE--Ausdruck-'
- CATALOG
- CATALOG ist eine optionale Klausel; wird sie nicht angegeben, nimmt CATALOG standardmäßig den
aktuellen WebSphere Message
Broker-Versionskatalog als Wert an. Zur expliziten
Verwendung des aktuellen Versionsnachrichtenkatalogs setzen Sie BIPmsgs auf allen Betriebssystemen ein.
- 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.
Sie können
Nachrichtennummern von 2951 bis 2999 angeben. 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 den Schweregrad sowie die Katalog- und Nachrichtennummer
-- angibt. Vier Einfügungen stehen zur Verfügung
LOG EVENT SEVERITY 1 CATALOG 'BIPmsgs' 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;