Administratorhandbuch > Diagnosewerkzeuge > TRACE_DUMP

TRACE_DUMP

Scriptfunktion: Gibt Werte des Speicherbereiches in eine Tracedatei aus.

Syntax

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

Syntax	Beschreibung/Format
Traceoption	Traceeinstellung 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
Tracelevel	Umfang des Traces Format: Script-Variable oder Zahl Die erlaubten Werte richten sich nach der ausgewählten Traceoption.
Speicherbereich	Aufzuzeichnender Speicherbereich 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" Sollen mehrere Speicherbereiche aufgezeichnet werden, so sind diese mit Kommata zu trennen.
Zusatzinfo	Beliebiger Text, der als Zusatzinfo dient. Format: Script-Literal oder Script-Variable

Rückgabewerte
"0" - Trace war erfolgreich. "20208" - Tracelevel ist nicht im zulässigen Bereich. "20209" - Der angegebene Speicherbereich wird nicht unterstützt. "20210" - Der XML-Verweis ist falsch. "20211" - Die Tabelle ist nicht vorhanden.

Anmerkungen

Die Scriptfunktion dient Diagnosezwecken und ist nur in enger Abstimmung mit dem Support zu verwenden!

Damit eine Traceausgabe erfolgen kann, sind folgende Punkte zu beachten:

Die angegebene Traceoption muss auch in der Systemübersicht in den Eigenschaften der Serverprozesse aktiviert sein.
Zusätzlich muss der angegebene Tracelevel mindestens so hoch sein, wie in den Eigenschaften eingestellt worden ist.

Die Traceausgabe wird in jene Datei geschrieben, die Sie in der INI-Datei des Servers festgelegt haben (siehe [TRACE]-Sektion).

Die Scriptfunktion LOG_DUMP funktioniert ähnlich. Sie schreibt jedoch das Ergebnis in die Logdatei und berücksichtigt dabei alle Werte.

Beispiel

Im Beispiel wird ein Trace für diverse Speicherbereiche veranlasst. Der Trace ist erfolgreich, wenn in den Eigenschaften der Serverprozesse ein Datenbank-Trace mit mindestens einem Tracelevel von 4 aktiviert wurde.

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

Siehe auch:

Script-Sprachmittel	Beschreibung
LOG_DUMP	Gibt Werte des Speicherbereiches in eine Logdatei aus.
TRACE	Gibt Werte in eine Tracedatei aus.

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support