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.
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.
· 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. |
Siehe auch Beispiel einer Trace-Datei