Monitoring Properties

imq.log.level [Can be used with imqcmd update bkr command]

String 

INFO

Logging level 

Specifies the categories of logging information that can be written to an output channel. Possible values, from high to low:  

ERROR




WARNING




INFO

Each level includes those above it (for example, WARNING includes ERROR).

imq.destination.logDeadMsgs

Boolean 

false

Log information about dead messages?  

If true, the following events will be logged:

• A destination is full, having reached its maximum size or message count.

• The broker discards a message for a reason other than an administrative command or delivery acknowledgment.

• The broker moves a message to the dead message queue.

imq.log.console.stream

String 

ERR

Destination for console output:  

OUT: stdout




ERR: stderr

imq.log.console.output

String 

ERROR|WARNING

Categories of logging information to write to console:  

NONE




ERROR




WARNING




INFO




ALL

The ERROR, WARNING, and INFO categories do not include those above them, so each must be specified explicitly if desired. Any combination of categories can be specified, separated by vertical bars (|).

imq.log.file.dirpath

String 

See Appendix A, Platform-Specific Locations of Message Queue^TM Data

Path to directory containing log file 

imq.log.file.filename

String 

log.txt

Name of log file 

imq.log.file.output

String 

ALL

Categories of logging information to write to log file:  

NONE




ERROR




WARNING




INFO




ALL

The ERROR, WARNING, and INFO categories do not include those above them, so each must be specified explicitly if desired. Any combination of categories can be specified, separated by vertical bars (|).

imq.log.file.rolloverbytes

Integer 

-1

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).

imq.log.file.rolloversecs

Integer 

604800 (one week)

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).

imq.log.syslog.output [Solaris platform only]

String 

ERROR

Categories of logging information to write to syslogd(1M):

NONE




ERROR




WARNING




INFO




ALL

The ERROR, WARNING, and INFO categories do not include those above them, so each must be specified explicitly if desired. Any combination of categories can be specified, separated by vertical bars (|).

imq.log.syslog.facility

String 

LOG_DAEMON

syslog facility for logging messages

Possible values mirror those listed on the syslog(3C) man page. Appropriate values for use with Message Queue include:

LOG_USER




LOG_DAEMON




LOG_LOCAL0




LOG_LOCAL1




LOG_LOCAL2




LOG_LOCAL3




LOG_LOCAL4




LOG_LOCAL5




LOG_LOCAL6




LOG_LOCAL7

imq.log.syslog.identity

String 

imqbrokerd_${imq.instanceName}

Identity string to be prefixed to all messages logged to syslog

imq.log.syslog.logpid

Boolean 

true

Log broker process ID with message?  

imq.log.syslog.logconsole

Boolean 

false

Write messages to system console if they cannot be sent to syslog?

imq.log.timezone

String 

Local time zone 

Time zone for log time stamps 

Possible values are the same as those used by the method java.util.TimeZone.getTimeZone.

Examples:

GMT




GMT-8:00




America/LosAngeles




Europe/Rome




Asia/Tokyo

imq.metrics.enabled

Boolean 

true

Enable writing of metrics information to Logger?

Does not affect the production of metrics messages (controlled by imq.metrics.topic.enabled).

imq.metrics.interval

Integer 

-1

Time interval, in seconds, at which to write metrics information to Logger 

Does not affect the time interval for production of metrics messages (controlled by imq.metrics.topic.interval).

A value of -1 denotes an indefinite interval (never write metrics information to Logger).

imq.metrics.topic.enabled

Boolean 

true

Enable production of metrics messages to metric topic destinations?  

If false, an attempt to subscribe to a metric topic destination will throw a client-side exception.

imq.metrics.topic.interval

Integer 

60

Time interval, in seconds, at which to produce metrics messages to metric topic destinations 

imq.metrics.topic.persist

Boolean 

false

Are metrics messages sent to metric topic destinations persistent?  

imq.metrics.topic.timetolive

Integer 

300

Lifetime, in seconds, of metrics messages sent to metric topic destinations