SET-USER-CALL-TRACE

This statement controls the logging of statements.

Scope of validity

SESDCN administration

Function

You use the SET-USER-CALL-TRACE administration statement for diagnostic purposes. It controls the logging of the call trace, i.e. of the CALL DML or SQL statements of one or more application programs and the associated SESAM/SQL responses (see also section “Diagnostics traces”).

You can turn the call trace on or off for all active users, selected users or a single user.

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

SET-USER-CALL-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 call trace on or off.

TRACE = *ON(...)
Turns the call trace on.

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

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

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

TRACE = *OFF(...)
Turns the call trace off.

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

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

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

USER = <user-identification>
Identifies exactly one user whose call 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 call 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-CALL-TRACE administration statement:

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

TRACE=PAR,TYPE=CALL[,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 call trace is turned on or off for all users in the configuration.

The same TRACE command can activate the message trace (see "SET-USER-MSG-TRACE") or the call and message trace if you enter the parameter TYPE=MSG or TYPE=(CALL,MSG) instead of TYPE=CALL 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.