Anfang des Inhaltsbereichs

Hintergrunddokumentation Trace-Optionen Dokument im Navigationsbaum lokalisieren

Verwendung

Mit Hilfe der Trace-Optionen können Sie bewirken, dass die Precompiler-Laufzeitumgebung die Ausführung des gesamten Anwendungsprogramms zur Laufzeit in der Trace-Datei <filename>.pctprotokolliert.

Hinweis

Wenn Sie nur einzelne eingebettete SQL-Anweisungen protokollieren möchten, dann verwenden Sie die TRACE-Anweisungen.

Der Trace lässt sich zusätzlich zur Laufzeit mittels des Werkzeugs IRTRACE aktivieren und deaktivieren.

Vorgehensweise

·       Geben Sie die gewünschte Default-Angabe für die Trace-Option beim Durchführen des Precompiler-Laufs in den Precompiler-Optionen an.

·       Setzen Sie die gewünschte Trace-Option für die Laufzeit in der Umgebungsvariablen SQLOPT.

Die folgende Tabelle zeigt die möglichen Trace-Optionen, die Sie beim Durchführen des Precompiler-Laufs und beim Aufrufen des Anwendungsprogramms angeben können:

-T

bewirkt die Protokollierung mit der Option TRACE SHORT

Jede ausgeführte SQL-Anweisung wird einschließlich der Rückmeldungen sqlcode und sqlerrd[2] protokolliert.

-X

bewirkt die Protokollierung mit der Option TRACE LONG

Jede ausgeführte SQL-Anweisung wird einschließlich der Rückmeldungen sqlcode und sqlerrd[2] sowie aller Parameterwerte protokolliert.

-F <trace_file_name>

ermöglicht die Angabe eines Namens für die Trace-Datei bei der Trace-Ausgabe, wenn diese nicht den Standardnamen <filename>.pct erhalten soll

Wenn Sie keine weitere Trace-Option angeben, dann wird gleichzeitig die Option TRACE SHORT aktiviert.

Wenn Sie für <trace_file_name> die Zeichenfolge pid oder PID angeben, dann wird der Name der Trace-Datei automatisch folgendermaßen gebildet: pid<prozess_id>.pct. Auf diese Weise können Sie mehrere Trace-Dateien parallel erzeugen. Standardmäßig wird gleichzeitig die Protokollierung ausgeschaltet, wenn Sie keine andere Trace-Option angeben.

 

Die folgende Tabelle zeigt die möglichen Trace-Optionen, die Sie nur beim Aufrufen des Anwendungsprogramms angeben können:

-N

unterdrückt die Protokollierung von Datums- und Zeitangaben für den Beginn und das Ende der Ausführung jeder SQL-Anweisung

-L <execution_time>

bewirkt die Protokollierung von SQL-Anweisungen, deren Ausführung länger als die angegebene <execution_time> dauert

Geben Sie <execution_time> in Sekunden an.

Die Protokollierung erfolgt automatisch mit der Option TRACE LONG. Datums- und Zeitangaben können nicht mit –N unterdrückt werden.

-Y <statement_count>

bewirkt die wechselseitige Protokollierung in zwei Trace-Dateien <filename>.pct und <filename>.prot im Arbeitsverzeichnis des Anwendungsprogramms.

Mit <statement_count> geben Sie an, wie viele SQL-Anweisungen dabei in jeder Datei protokolliert werden. Wenn die Anzahl der SQL-Anweisungen <statement_count> übersteigt, dann werden die Trace-Dateien zyklisch überschrieben.

Wenn Sie diese Option angeben, dann erfolgt die Protokollierung automatisch mit der Option TRACE LONG. Datums- und Zeitangaben können nicht mit –N unterdrückt werden.

Hinweis

Siehe auch Beispiel einer Trace-Datei

 

Ende des Inhaltsbereichs