TRACE_DUMP

Verwenden Sie die Script-Funktion TRACE_DUMP, um den Wert des Speicherbereichs in einer Trace-Datei bereitzustellen.

Syntax

TRACE_DUMP (Trace option, trace level, memory range[, memory range,...][, additional info])

Parameter

• TRACE_DUMP

  Gibt Werte des Speicherbereichs 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.

• Speicherbereich

  Speicherbereich, der aufgezeichnet werden soll

  Format: Script-Literal oder Script-Variable

  Erlaubte Werte:

  "WORK MEMORY"

  "LOCAL MEMORY"

  "XML + XML-Handle"

  "DB + Tabellenname (Spaltenname;Spaltenname;.....)"

  "DB + Tabellenname"

  "SCRIPT_VARA"

  "SCRIPT_PRG"

  "USER_TAB"

  "CLNT_TAB"

  "EX_TAB"

  "*_TAB"

  "GIVE_ME_ALL"

  Hinweis: Trennen Sie mehrere aufzuzeichnende Speicherbereiche mit Kommas.

• Zusätzliche Info

  Alle zusätzlichen Texte oder Informationen

  Format: Script-Literal oder Script-Variable

Rückgabewerte

• 0

  Der Trace war erfolgreich

• 20208

  Der Trace-Level liegt nicht im zulässigen Bereich

• 20209

  Der angegebene Speicherbereich wird nicht unterstützt

• 20210

  Das XML-Handle ist falsch

• 20211

  Die Tabelle existiert nicht

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“ (Erweiterte Optionen - Tracing) aktiviert werden.

  • 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]).

• Die Script-Funktion LOG_DUMP funktioniert ähnlich, schreibt das Ergebnis aber in die Logdatei und berücksichtigt alle Werte.

Beispiel

Im untenstehenden Beispiel wird ein Trace für mehrere Speicherbereiche aktiviert. Der Trace ist erfolgreich, wenn in den Eigenschaften der Serverprozesse ein Datenbank-Trace mit mindestens einem von vier Trace-Levels aktiviert wurde.

:SET &RET# = TRACE_DUMP(2,4, "DB + XAO(XAO_Idnr, XAO_MsgNr), LOCAL_MEMORY, SCRIPT_VARA", "Various Information")

Siehe auch:

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