Sun Java System Message Queue 4.1 Developer's Guide for JMX Clients

Log Configuration

Each broker has a single log configuration MBean, used for configuring Message Queue logging.

Object Name

The log configuration MBean has the following object name:

com.sun.messaging.jms.server:type=Log,subtype=Config

A string representing this object name is defined as a static constant LOG_CONFIG_MBEAN_NAME in the utility class MQObjectName.

Attributes

The log configuration MBean has the attributes shown in Table 3–84. The names of these attributes are defined as static constants in the utility class LogAttributes.

Table 3–84 Log Configuration Attributes

Name 

Type 

Settable? 

Description 

Level

String

Yes 

Logging level 

Specifies the categories of logging information that can be written to an output channel. See Table 3–85 for possible values.

RolloverBytes

Long

Yes 

File length, in bytes, at which output rolls over to a new log file 

A value of -1 denotes an unlimited number of bytes (no rollover based on file length).

RolloverSecs

Long

Yes 

Age of file, in seconds, at which output rolls over to a new log file 

A value of -1 denotes an unlimited number of seconds (no rollover based on file age).

Table 3–85 shows the possible values for the Level attribute. Each level includes those above it (for example, WARNING includes ERROR). These values are defined as static constants in the utility class LogLevel.

Table 3–85 Log Configuration Logging Levels

Name 

Utility Constant 

Meaning 

NONE

LogLevel.NONE

No logging 

ERROR

LogLevel.ERROR

Log error messages 

WARNING

LogLevel.WARNING

Log warning messages 

INFO

LogLevel.INFO

Log informational messages 

UNKNOWN

LogLevel.UNKNOWN

Logging level unknown 

Notification

The log configuration MBean supports the notification shown in Table 3–86.

Table 3–86 Log Configuration Notification

Name 

Description 

jmx.attribute.change

Attribute value changed