SET-USER-MSG-TRACE

Protokollierung von SESAM/SQL-Nachrichten steuern

Geltungsbereich

SESDCN-Administration

Funktionsbeschreibung

Die Administrationsanweisung SET-USER-MSG-TRACE dient Diagnosezwecken. Hiermit steuern Sie die Protokollierung von SESAM/SQL-Nachrichten, die zwischen der Task eines Anwenderprogramms und der Task eines SESAM/SQL-DBH ausgetauscht werden (Message-Trace). Neben Anwenderprogramm-Anweisungen und den zugehörigen SESAM/SQL-Antworten enthält der Message Trace noch SESAM/SQL-interne Verwaltungsinformationen (siehe auch Abschnitt „Diagnose-Traces“).

Sie können den Message-Trace für alle aktiven Auftraggeber oder für bestimmte, ausgewählte Auftraggeber ein- oder ausschalten.

Die Protokollierung erfolgt durch alle Anwenderprogramme, die derselben Konfiguration angehören wie SESDCN, und in denen der oder die spezifizierte/n Auftraggeber aktiv ist bzw. sind.

SET-USER-MSG-TRACE

TRACE = *ON(...) / *OFF(...)
	*ON(...)
		|	OUTPUT = SYSLST / list-poss(2): SYSLST / SYSOUT
	*OFF(...)
		|	OUTPUT = (SYSLST,SYSOUT) / list-poss(2): SYSLST / SYSOUT
,USER = <user-identification> / *ALL

Operandenbeschreibung

TRACE = *ON(...) / *OFF(...)

Schaltet den Message-Trace für die bei Output angegebenen Medien ein oder aus.

TRACE = *ON(...)
Der Message-Trace wird eingeschaltet.

OUTPUT =
Bestimmt das Ausgabemedium für den Message-Trace der Anwendungsprogramme.

OUTPUT = SYSLST
Standardwert. Der Message-Trace wird auf SYSLST protokolliert.

OUTPUT = list-poss (2): SYSLST / SYSOUT
Der Message-Trace wird wahlweise nur auf SYSLST oder nur auf SYSOUT oder auf SYSLST und SYSOUT protokolliert.

TRACE = *OFF(...)
Der Message-Trace wird ausgeschaltet.

OUTPUT =
Bestimmt das Ausgabemedium für den Message-Trace der Anwendungsprogramme, das ausgeschaltet wird.

OUTPUT = (SYSLST,SYSOUT)
Standardwert. Die Protokollierung des Message-Trace wird sowohl für SYSLST als auch für SYSOUT ausgeschaltet.

OUTPUT = list-poss (2): SYSLST / SYSOUT
Die Protokollierung des Message-Trace wird für SYSLST oder für SYSOUT oder für beide ausgeschaltet.

USER = <user-identification>
Identifiziert genau einen Auftraggeber, dessen Message-Trace ein- oder ausgeschaltet wird. Die Identifikation des Auftraggebers muss eindeutig sein (siehe Abschnitt „Syntax für die Identifikation von Auftraggebern“).

USER = *ALL
Der Message-Trace wird für alle aktiven Auftraggeber ein- oder ausgeschaltet.

Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle

Hier entspricht der Administrationsanweisung SET-USER-MSG-TRACE das Administrationskommando TRACE mit folgenden zwei Formaten:

Format 1:
Das TRACE-Kommando setzt die Parameter, die bei der später eingeschalteten Protokollierung gültig sein sollen.

TRACE=PAR,TYPE=MSG[,OUTPUT={SYSOUT|SYSLST|(SYSOUT,SYSLST)}]

Format 2:
Das TRACE-Kommando schaltet die Protokollierung auftraggeber-orientiert ein oder aus.

TRACE={ON|OFF}[,USER=[host],[application],[user][,vgid]]

Wenn Sie den Parameter USER nicht angeben, wird die Protokollierung des Message-Trace für alle Auftraggeber der Konfiguration ein- oder ausgeschaltet.

Dasselbe TRACE-Kommando kann den Call-Trace (siehe "SET-USER-CALL-TRACE") bzw. den Call- und den Message-Trace aktivieren, wenn Sie beim TRACE-Kommando im Format 1 statt des Parameters TYPE=MSG den Parameter TYPE=CALL bzw. TYPE=(CALL,MSG) eintragen.

Die Protokollierung erfolgt immer nach den aktuell gültigen Werten der Parameter TYPE und OUTPUT, also nach den Werten, die zuletzt mit dem TRACE-Kommando im Format 1 gesetzt wurden.

Wurde im Laufe der Session noch kein TRACE-Kommando im Format 1 eingegeben, so gelten für die Parameter TYPE und OUTPUT die Standardwerte CALL und SYSLST.