TRACE

Verwenden Sie die Script-Funktion TRACE, um Werte in eine Trace-Datei auszugeben. Die Trace-Ausgabe wird in die Datei geschrieben, die im Abschnitt [TRACE] der INI-Datei der Automation Engine angegeben ist, siehe Automation Engine.

Wichtig! Diese Skriptfunktion dient nur zu Diagnosezwecken. Sie kann in kurzer Zeit riesige Datenmengen generieren und dies kann die Systemleistung erheblich beeinträchtigen. Verwenden Sie sie, wenn das Support-Team Sie ausdrücklich dazu anweist. Der Ihnen zugeteilte Support-Mitarbeiter weiß, welche Werte eingestellt werden müssen, um die erforderlichen Daten mit einem Minimum an Systemauswirkungen zu sammeln.

Weitere Informationen finden Sie unter Diagnose-Tools: Logs und Traces.

Syntax

TRACE (Trace-Option, Trace-Ausgabe)

Parameter

  • Trace-Option

    Gibt an, welcher Typ von Informationen in den Trace geschrieben werden soll.

    Format: Script-Variable oder Zahl

    Zulässige Werte:

    • 1 TCP/IP

    • 2 Datenbank

    • 3 FileTransfer

    • 4 Srcall

    • 5 Memio

    • 6 JCL

      Für Automation Engine-Prozesse bedeutet dieser Wert Rest-Tracing für REST-Prozesse und JCL für alle anderen Prozesse.

    • 7 Memsv

    • 8 SNMP

    • 9 Zuxml

    • 10 Cache

    • 11 Reporting

    • 12 Ucds

    • 13 Xscript

    • 14 UC4global

    • 14 global

    • 15 Intern

    • 16 Minimal

  • Trace-Level

    Detail-Level für Ihren Trace.

    Zulässige Werte: Die zulässigen Werte hängen von der gewählten Trace-Option ab.

    Wichtig! Obwohl das Tracing hilfreich sein kann, generiert es doch in kurzer Zeit riesige Datenmengen, was die Systemleistung erheblich beeinträchtigen kann. Verwenden Sie Trace-Optionen dann, wenn das Support-Team Sie ausdrücklich dazu anweist. Der Ihnen zugeteilte Support-Mitarbeiter weiß, welche Werte eingestellt werden müssen, um die erforderlichen Daten mit einem Minimum an Systemauswirkungen zu sammeln.

  • Format: Script-Variable oder Zahl

  • Trace-Ausgabe

    Jeder Text, der als Trace-Ausgabe dient

    Format: Script-Literal oder Script-Variable

Rückgabewerte

  • 0

    Der Trace war erfolgreich

  • 20208

    Der Trace-Level liegt nicht im zulässigen Bereich

Beispiel

Im folgenden Beispiel wird ein Trace für den Inhalt einer Script-Variablen aktiviert. Der Trace ist erfolgreich, wenn in den Eigenschaften der Serverprozesse ein Datenbank-Trace mit mindestens einem von vier Trace-Levels aktiviert wurde.

: SET   &NUMBER# = 10
: SET   &RET# = TRACE (2,4, "Die variable NUMBER hat den Wert: &NUMBER#" )

Siehe auch: