TRACE

Verwenden Sie die Script-Funktion TRACE, um Werte in eine Trace-Datei auszugeben.

Syntax

TRACE (Trace-Option, Trace-Ausgabe)

Parameter

• TRACE

  Gibt Werte in eine Trace-Datei aus

• Trace-Option

  Trace-Einstellung

  Format: Script-Variable oder Zahl

  Zulässige Werte:

  • 1 TCP/IP
  • 2 Datenbank
  • 4 Srcall
  • 5 Memio
  • 6 JCL
  • 7 Memsv
  • 8 SNMP
  • 9 Zuxml
  • 10 Cache
  • 12 Ucds
  • 13 Xscript
  • 14 UC4global
  • 16 Minimal

• Trace-Level

  Trace-Größe

  Format: Script-Variable oder Zahl

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

• 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

Hinweise:

• Diese Script-Funktion dient nur zu Diagnosezwecken und darf nur in enger Zusammenarbeit mit dem Support-Team verwendet werden!

• Um die Trace-Ausgabe zu aktivieren, beachten Sie die folgenden Anweisungen:

  • Die angegebene Trace-Option muss auch in der Administration-Perspektive in den Eigenschaften der Serverprozesse aktiviert sein, siehe Seite Prozesse und Auslastung.

  • Zusätzlich muss der angegebene Trace-Level mindestens so hoch sein, wie in den Eigenschaften eingestellt.

• Die Trace-Ausgabe wird in die Datei geschrieben, die im Abschnitt [TRACE] der INI-Datei der Automation Engine angegeben ist, siehe Automation Engine.

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:

• Logging/Trace
• LOG_DUMP
• TRACE_DUMP
• Scripting