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, Speicherbereich[, Speicherbereich,...][, zusätzliche Informationen])

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 die Trace-Ausgabe zu aktivieren, beachten Sie die folgenden Anweisungen:

    • Die angegebene Trace-Option muss auch in der Administration-Perspektive aktiviert werden (Erweiterte Optionen - Tracing).

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

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

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: