Sun GlassFish Message Queue 4.4 Developer's Guide for JMX Clients

Destination Manager Monitor

Each broker has a single destination manager monitor MBean, used for managing all of the broker's destination monitor MBeans.

Object Name

The destination manager monitor MBean has the following object name:

com.sun.messaging.jms.server:type=DestinationManager,subtype=Monitor

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

Attributes

The destination manager monitor MBean has the attributes shown in Table 3–49. The names of these attributes are defined as static constants in the utility class DestinationAttributes.

Table 3–49 Destination Manager Monitor Attributes

Name 

Type 

Settable? 

Description 

NumDestinations

Integer

No 

Current total number of destinations 

NumMsgs

Long

No 

Current total number of messages stored in memory and persistent store for all destinations 

Does not include messages held in transactions. 

TotalMsgBytes

Long

No 

Current total size in bytes of messages stored in memory and persistent store for all destinations 

Does not include messages held in transactions.  

NumMsgsInDMQ

Long

No 

Current number of messages stored in memory and persistent store for dead message queue

TotalMsgBytesInDMQ

Long

No 

Current total size in bytes of messages stored in memory and persistent store for dead message queue

Operation

The destination manager monitor MBean supports the operation shown in Table 3–50. The name of this operation is defined as a static constant in the utility class DestinationOperations.

Table 3–50 Destination Manager Monitor Operation

Name 

Parameters 

Result Type 

Description 

getDestinations

None 

ObjectName[]

Object names of destination monitor MBeans for all current destinations 

Notifications

The destination manager monitor MBean supports the notifications shown in Table 3–51. These notifications are instances of the Message Queue JMX class DestinationNotification, and their names are defined as static constants in that class.

Table 3–51 Destination Manager Monitor Notifications

Name 

Utility Constant 

Description 

mq.destination.create

DestinationNotification.DESTINATION_CREATE

Destination created 

mq.destination.destroy

DestinationNotification.DESTINATION_DESTROY

Destination destroyed 

mq.destination.pause

DestinationNotification.DESTINATION_PAUSE

Destination paused 

mq.destination.resume

DestinationNotification.DESTINATION_RESUME

Destination resumed 

mq.destination.compact

DestinationNotification.DESTINATION_COMPACT

Destination compacted 

mq.destination.purge

DestinationNotification.DESTINATION_PURGE

Destination purged 

Table 3–52 shows the methods defined in class DestinationNotification for obtaining details about a destination manager monitor notification.

Table 3–52 Data Retrieval Methods for Destination Manager Monitor Notifications

Method 

Result Type 

Description 

getDestinationName

String

Destination name 

getDestinationType

String

Destination type 

See Table 3–46 for possible values.

getCreatedByAdmin

Boolean

Administrator-created destination?  

getPauseType

String

Pause type 

See Table 3–47 for possible values.