This section describes the MBeans used for managing message brokers:
The broker configuration MBean configures a message broker.
The broker monitor MBean monitors a message broker.
The following subsections describe each of these MBeans in detail.
The broker configuration MBean is used for configuring a message broker. There is one such MBean for each broker.
The broker configuration MBean has the following object name:
com.sun.messaging.jms.server:type=Broker,subtype=Config
A string representing this object name is defined as a static constant BROKER_CONFIG_MBEAN_NAME in the utility class MQObjectName.
The broker configuration MBean has the attributes shown in Table 2–1. The names of these attributes are defined as static constants in the utility class BrokerAttributes.
Table 2–1 Broker Configuration Attributes
Name |
Type |
Settable? |
Description |
---|---|---|---|
String |
No |
Appended to database table names to make them unique when more than one broker instance is using the same database as a persistent data store. If a database is not used as the persistent data store, the value of this attribute is null. |
|
String |
No |
Broker version |
|
String |
No |
Broker instance name Example: imqbroker |
|
Integer |
Yes |
Port number of Port Mapper |
The broker configuration MBean supports the operations shown in Table 2–2. The names of these operations are defined as static constants in the utility class BrokerOperations.
Table 2–2 Broker Configuration Operations
The broker configuration MBean supports the notification shown in Table 2–3.
Table 2–3 Broker Configuration Notification
Name |
Description |
---|---|
Attribute value changed |
The broker monitor MBean is used for monitoring a message broker. There is one such MBean for each broker.
The broker monitor MBean has the following object name:
com.sun.messaging.jms.server:type=Broker,subtype=Monitor
A string representing this object name is defined as a static constant BROKER_MONITOR_MBEAN_NAME in the utility class MQObjectName.
The broker monitor MBean has the attributes shown in Table 2–4. The names of these attributes are defined as static constants in the utility class BrokerAttributes.
Table 2–4 Broker Monitor Attributes
Name |
Type |
Settable? |
Description |
---|---|---|---|
String |
No |
Appended to database table names to make them unique when more than one broker instance is using the same database as a persistent data store. If a database is not used as the persistent data store, the value of this attribute is null. |
|
String |
No |
Broker version |
|
String |
No |
Broker instance name |
|
Integer |
No |
Port number of Port Mapper |
|
Boolean |
No |
Is broker embedded (started from within another process)? |
The broker monitor MBean supports the notifications shown in Table 2–5. These notifications are instances of the Message Queue JMX classes BrokerNotification and ClusterNotification, and their names are defined as static constants in those classes.
Table 2–5 Broker Monitor Notifications
Name |
Utility Constant |
Description |
---|---|---|
Broker has begun shutting down |
||
Broker has begun quiescing |
||
Broker has finished quiescing |
||
Broker has joined a cluster |
Table 2–6 shows the methods defined in class BrokerNotification for obtaining details about a broker monitor notification. See Table 2–83 for the corresponding methods of class ClusterNotification.
Table 2–6 Data Retrieval Methods for Broker Monitor Notifications
Method |
Return Type |
Description |
---|---|---|
String | ||
String |
Broker address, in the form hostName:portNumber Example: host1:3000 |