Event logging: TRACE parameter section

The TRACE parameter set allows you to specify which events are logged and where the trace entries are written.

Syntax

TRACE = PARAMETERS( ... )
		|	SOCKET_TRACE = <level>
		|	,TLS = <level>
		|	,PROTOCOL = <level>
		|	,IO = <level>
		|	,SMIME = <level>
		|	,HEADER = <level>
		|	,LEVEL = <level>
		|	,PARSE = <level>
		|	,STRING = <level>
		|	,FILENAME = <trace file>

Operand description

SOCKET_TRACE = <level>
You can use this to activate the logging of the SOCKETS subsystem. <level> specifies the trace level. The higher the value specified for <level>, the more detailed the trace data output to SYSOUT. Level 0 deactivates the trace. The SOCKET_TRACE operand is independent of the LEVEL operand.
By default, the socket trace is not activated.

TLS = <level>
Controls the logging of specific actions/events during the processing of the TLS protocol.

0 1	Logging deactivated (default). Logging activated. A trace is only output when the LEVEL has the value 0.

PROTOCOL =<level>
Controls the logging of specific events of the POP3/IMAP protocol such as the fetching or deletion of an e-mail.
<level> specifies the trace level: the higher the value specified for <level>, the more trace entries are written. A level of 0 suppresses all trace entries (default). The maximum trace level is 2. A trace is only output when the LEVEL operand has a value of 0.

IO=<level>
Allows you to activate logging of the data traffic with the POP3/IMAP server.

0 1	Logging deactivated (default). Logging activated. A trace is only output when the LEVEL operand has a value of 0.

SMIME =<level>
Controls the logging of specific actions during S/MIME decryption and/or verification. <level> specifies the trace level. The higher the value for <level>, the more trace entries are written. A level of 0 suppresses all trace entries.
The default value is 0.
The maximum trace level is 2. A trace is only output when the LEVEL operand has a value of 0.

HEADER =<level>
Specifies the level for the logging of events that occur when procedure and message files are created. <level> specifies the trace level. The higher the value for <level>, the more trace entries are written. A level of 0 suppresses all trace entries.
The default value is 0.
The maximum trace level is 3. A trace is only output when the LEVEL operand has a value of 0.

PARSE =<level>
Specifies the level of the trace for events when the configuration file is read in. <level> specifies the trace level. The higher the value for <level>, the more trace entries are written. A level of 0 suppresses all trace entries.
The default value is 0.
The maximum trace level is 2.

LEVEL =<level>
Controls the output of the PROTOCOL, IO and HEADER traces and other events from different message classes in accordance with the following table:

0	TLS, PROTOCOL, IO, SMIME and HEADER traces and INFO, WARNING, ERROR and FATAL events are logged.
1	INFO, WARNING, ERROR and FATAL events are logged. TLS, PROTOCOL, IO, SMIME and HEADER traces are not logged.
2	WARNING, ERROR and FATAL events are logged. TLS, PROTOCOL, IO, SMIME and HEADER traces are not logged.
3	ERROR, FATAL events are logged. TLS, PROTOCOL, IO, SMIME and HEADER traces are not logged.

FILENAME =<trace file>
Specifies the output file for the trace entries. If this parameter is not specified, the trace entries are output to SYSOUT.

Example

In this example, all the events of the POP3/IMAP protocol with a level of 1 are written to SYSOUT.

TRACE = PARAMETERS (
   PROTOCOL = 1,
   LEVEL = 0
)