SET-USER-MSG-TRACE

This statement controls the logging of SESAM/SQL messages.

Scope of validity

SESDCN administration

Function

You use the SET-USER-MSG-TRACE administration statement for diagnostic purposes. It controls the logging of SESAM/SQL messages exchanged between the task of an application program and the task of a SESAM/SQL DBH (message trace). In addition to application-program statements and the associated SESAM/SQL replies, the message trace also receives internal SESAM/SQL administration information (see also section “Diagnostics traces”).

You can turn the message trace on or off for all active users or for selected users.

Statements issued in all application programs that belong to the same configuration as SESDCN and in which the specified user(s) is/are active are logged.

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

Operands

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

Turns the message trace on or off for the medium specified in OUTPUT.

TRACE = *ON(...)
The message trace is turned on.

OUTPUT =
Specifies the output medium for the message trace of the application program.

OUTPUT = SYSLST
This is the default. The message trace is logged to SYSLST.

OUTPUT = list-poss (2): SYSLST / SYSOUT
The message trace is logged only to SYSLST, only to SYSOUT, or to SYSLST and SYSOUT.

TRACE = *OFF(...)
The message trace is turned off.

OUTPUT =
Specifies the output medium for the message trace of the application program to be turned off.

OUTPUT = (SYSLST,SYSOUT)
This is the default. Logging of the message trace is turned off for SYSLST as well as for SYSOUT.

OUTPUT = list-poss (2): SYSLST / SYSOUT
Logging of the message trace is turned off for SYSLST, for SYSOUT or for both.

USER = <user-identification>
Identifies exactly one user whose message trace is to be turned on or off. The user must be identified uniquely (see the section “Syntax for the identification of users”).

USER = *ALL
Turns the message trace on or off for all active users.

Administration command in ISP format and at the CALL DML interface

The TRACE administration command in the following two formats corresponds to the SET-USER-MSG-TRACE administration statement:

Format 1:
The TRACE command sets the parameters that are to apply when logging is subsequently turned on.

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

Format 2:
The TRACE command turns logging on or off user specifically.

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

If you do not specify the USER parameter, logging of the message trace is turned on or off for all users in the configuration.

The same TRACE command can activate the call trace (see "SET-USER-CALL-TRACE") or the call trace and message trace if you enter the parameter TYPE=CALL or TYPE=(CALL,MSG) instead of TYPE=MSG for the TRACE command in format 1.

Logging is always carried out based on the current values of the TYPE and OUTPUT parameters, i.e. on the values last set by means of the TRACE command in format 1.

If you do not issue a TRACE command in format 1 during the session, the defaults CALL and SYSLST apply to the TYPE and OUTPUT parameters.