TRACE

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

Syntax

TRACE (Trace option, trace level, trace output)

Parameter

• TRACE

  Gibt Werte in eine Trace-Datei aus

• Trace-Option

  Trace-Einstellung

  Format: Script-Variable oder Zahl

  Erlaubte 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-Output

  Jeder Text, der als Trace-Output 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 den Trace-Output zu aktivieren, beachten Sie die folgenden Anweisungen:

  • Die angegebene Trace-Option muss auch in der Perspektive „Administration“ aktiviert sein (in den Eigenschaften der Serverprozesse, siehe Seite „Prozesse & Auslastung“).

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

• Der Trace-Output wird in die in der INI-Datei des Servers angegebene Datei geschrieben (siehe Abschnitt [TRACE]).

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,"The variable NUMBER has the value: &NUMBER#")

Siehe auch:

• LOG_DUMP - Gibt Werte des Speicherbereichs in eine Trace-Datei aus
• TRACE_DUMP - Gibt Werte des Speicherbereichs in eine Trace-Datei aus
• Funktionale Logik mit Scripts