Java CAPS JMS Reference

Diagnostics Page

Diagnostic Properties

Figure 1–23 Diagnostic Properties Panel

Screen capture showing Logging Level properties
options.

The generation of log files for diagnostic purposes can have a major impact on system resources. You can specify several properties for logging, as described in the following sections:

Logging Level

The Logging Level property specifies the threshold severity level at which the system issues log messages. The JMS IQ Manager only issues log messages having a severity level that is higher than or equal to the specified level.

Table 1–11 Logging Levels

Level 

Message Types Issued 

FATAL 

Fatal 

ERROR 

Fatal, Error 

WARN 

Fatal, Error, Warning 

INFO 

All 

Default Setting

By default, the logging level is specified as WARN, and the JMS IQ Manager issues warning, error, and fatal messages.

Logging Level of Journaler

The Logging Level of Journaler property specifies the threshold severity level at which the system journals log messages. The JMS IQ Manager only journals log messages having a severity level that is higher than or equal to the specified level.

Table 1–12 Journaler Logging Levels

Level 

Message Types Journaled 

FATAL 

Fatal 

ERROR 

Fatal, Error 

WARN 

Fatal, Error, Warning 

INFO 

All 

By default, the journal log file resides in the journal directory in the JMS IQ Manager directory. The location of this directory can be specified with the Journal Directory property as described in Journal Directory.

Default Condition

By default, the journaling level is specified as ERROR, and the JMS IQ Manager journal log includes only error and fatal messages.

Maximum Log File Size

You can specify the maximum size for the JMS IQ Manager log file with the Maximum Log File Size property. If the JMS IQ Manager attempts to log more than the specified log file size, the log file is renamed to stcms.log.N, and a new file is created.

The variable N is a number between 1 and the number specified by the Number of Backup Log Files property. By default, the JMS IQ Manager can create five backup log files.

Allowed Values

An integer larger than 0, indicating the size of the log file in MBytes.

Default value

The default log file size is 10 MBytes.

Number of Backup Log Files

You can specify the maximum number of backup log files in the JMS IQ Manager database with the Number of Backup Log Files property. When the specified number is exceeded, the oldest log file is discarded.

Allowed Values

An integer greater than 0, indicating the number of backup log files.

Default value

The default number of backup log files is 5.