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

Connection Manager Monitor

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

Object Name

The connection manager monitor MBean has the following object name:

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

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

Attributes

The connection manager monitor MBean has the attributes shown in Table 3–28. The names of these attributes are defined as static constants in the utility class ConnectionAttributes.

Table 3–28 Connection Manager Monitor Attributes

Name 

Type 

Settable? 

Description 

NumConnections

Integer

No 

Current number of connections 

NumConnectionsOpened

Long

No 

Cumulative number of connections opened since broker started 

NumConnectionsRejected

Long

No 

Cumulative number of connections rejected since broker started 

Operation

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

Table 3–29 Connection Manager Monitor Operation

Name 

Parameters 

Result Type 

Description 

getConnections

None 

ObjectName[]

Object names of connection monitor MBeans for all current connections 

Notifications

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

Table 3–30 Connection Manager Monitor Notifications

Name 

Utility Constant 

Description 

mq.connection.open

ConnectionNotification.CONNECTION_OPEN

Connection opened 

mq.connection.reject

ConnectionNotification.CONNECTION_REJECT

Connection rejected 

mq.connection.close

ConnectionNotification.CONNECTION_CLOSE

Connection closed 

Table 3–31 shows the methods defined in class ConnectionNotification for obtaining details about a connection manager monitor notification.

Table 3–31 Data Retrieval Methods for Connection Manager Monitor Notifications

Method 

Result Type 

Description 

getConnectionID

String

Connection identifier 

getRemoteHost

String

Host from which connection was made 

getServiceName

String

Connection service name 

getUserName

String

User name