JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server Message Queue 4.5 Administration Guide
search filter icon
search icon

Document Information

Preface

Part I Introduction to Message Queue Administration

1.  Administrative Tasks and Tools

2.  Quick-Start Tutorial

Part II Administrative Tasks

3.  Starting Brokers and Clients

4.  Configuring a Broker

5.  Managing a Broker

6.  Configuring and Managing Connection Services

7.  Managing Message Delivery

8.  Configuring Persistence Services

9.  Configuring and Managing Security Services

10.  Configuring and Managing Broker Clusters

11.  Managing Administered Objects

12.  Configuring and Managing Bridge Services

13.  Monitoring Broker Operations

14.  Analyzing and Tuning a Message Service

15.  Troubleshooting

Part III Reference

16.  Command Line Reference

17.  Broker Properties Reference

Connection Properties

Routing and Delivery Properties

Persistence Properties

File-Based Persistence Properties

File-Based Persistence Properties for Transaction Logging

JDBC-Based Persistence Properties

Security Properties

Monitoring Properties

Cluster Configuration Properties

Bridge Properties

JMX Properties

Alphabetical List of Broker Properties

18.  Physical Destination Property Reference

19.  Administered Object Attribute Reference

20.  JMS Resource Adapter Property Reference

21.  Metrics Information Reference

22.  JES Monitoring Framework Reference

Part IV Appendixes

A.  Distribution-Specific Locations of Message Queue Data

B.  Stability of Message Queue Interfaces

C.  HTTP/HTTPS Support

D.  JMX Support

E.  Frequently Used Command Utility Commands

Index

Monitoring Properties

Table 17-13 lists the broker properties related to monitoring services.

Table 17-13 Broker Monitoring Properties

Property
Type
Default Value
Description
imq.log.level1
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.logDeadMsgs1
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
IMQ_VARHOME/instances/instanceName/log
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.rolloverbytes1
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.rolloversecs1
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.output2
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.facility2
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.identity2
String
imqbrokerd_${imq.instanceName}
Identity string to be prefixed to all messages logged to syslog
imq.log.syslog.logpid2
Boolean
true
Log broker process ID with message?
imq.log.syslog.logconsole2
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
imq.primaryowner.name3
String
System property user.name (user who started the broker)
Name of primary system owner
imq.primaryowner.contact3
String
System property user.name (user who started the broker)
Contact information for primary system owner
imq.broker.adminDefinedRoles.count3
Integer
None
Number of defined roles
imq.broker.adminDefinedRoles.nameN3
String
Broker instance name
Name of defined role N (where N ranges from 0 to .count-1)

Example:

...name0=Stocks JMS Server
...name1=JMS provider for appserver

1Can be used with imqcmd update bkr command

2Solaris platform only

3Used by JES Monitoring Framework