TRACE_DUMP

Verwenden Sie die Skriptfunktion TRACE_DUMP, um Werte der Speicherbereiche in eine Logdatei 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_DUMP (Trace-Option, Trace-Level, Speicherbereich[, Speicherbereich,...][, zusätzliche Informationen])

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

    • 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

    • 12 Ucds

    • 13 Xscript

    • 14 UC4global

    • 16 Minimal

  • Trace-Level

    Trace-Größe

    Format: Script-Variable oder Zahl

    Zulässige Werte: 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

    Zulässige 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.

  • Zusatzinfo

    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

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" , "Verschiedene Informationen" )

Siehe auch: