Administratorhandbuch > Diagnosewerkzeuge > TRACE

TRACE

Script-Funktion: Gibt Werte in eine Tracedatei aus.

Syntax

TRACE (Trace option, trace level, trace output)

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.
Traceausgabe	Beliebiger Text, der als Traceausgabe dient. Format: Script-Literal oder Script-Variable

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.

Traceausgabe

Beliebiger Text, der als Traceausgabe dient.

Format: Script-Literal oder Script-Variable

Rückgabewerte
"0" - Der Trace war erfolgreich. "20208" - Das Tracelevel ist nicht im erlaubten Bereich.

Kommentare

Die Script-Funktion 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).

Beispiel

Im Beispiel wird ein Trace des Inhalts einer Script-Variable veranlasst. Der Trace ist erfolgreich, wenn in den Eigenschaften der Serverprozesse ein Datenbank-Trace mit mindestens einem Tracelevel von 4 aktiviert wurde.

:SET &NUMBER# = 10
:SET &RET# = TRACE(2,4,"The variable NUMBER has the value: &NUMBER#")

Siehe auch:

Script-Sprachmittel	Beschreibung
LOG_DUMP	Gibt Werte des Speicherbereiches in eine Logdatei aus.
TRACE_DUMP	Gibt Werte des Speicherbereiches 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