Sun Java System Message Queue 4.3 Administration Guide

Chapter 21 JES Monitoring Framework Reference

This chapter describes the monitoring information items that Message Queue exposes through the Sun JavaTM Enterprise System Monitoring Framework (JESMF), using the Monitoring Framework’s Common Monitoring Model (CMM). It contains the following sections:

Common Attributes

The attributes listed in Table 21–1 are common to all (or almost all) CMM objects.

Table 21–1 JESMF Common Object Attributes

Attribute 

Description 

Name

Object name 

Caption

Short description 

Description

Full description 

LastUpdateTime

Time last updated 

OperationalStatus

Current status (for example, OK or DORMANT)

StatusDescriptions

Description of status 

OperationalStatusLastChange

Time of last change in operational status 

Message Queue Product Information

Table 21–2 shows attributes of the Message Queue product itself that can be accessed with JESMF.

Table 21–2 JESMF-Accessible Message Queue Product Attributes

Attribute 

Description 

ProductName

Product name 

ProductIdentifyingNumber

Identifying number of product, in the form  

    urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx


Value changes for every version.  

ProductVendor

Vendor name 

ProductVersion

Version number 

RevisionNumber

Revision number 

BuildNumber

Build number 

PatchID

Patch identifier (if any) 

CollectionID

Identification key for installed product object 

Differentiates among product installations; usually identifies the installation location.  

InstallDate

Installation date 

Broker Information

Table 21–3 shows the JESMF-accessible attributes pertaining to each broker instance.

Table 21–3 JESMF-Accessible Message Queue Broker Attributes

Attribute 

Description 

PrimaryOwnerName

Name of primary system owner (broker property imq.primaryowner.name; see Table 16–10)

PrimaryOwnerContact

Contact information for primary system owner (broker property imq.primaryowner.contact; see Table 16–10)

Roles

Array of strings denoting broker’s roles (taken from broker properties imq.broker.adminDefinedRoles.namen; see Table 16–10)

StartupTime

Time of last startup (date and time in milliseconds) 

URL

URL of Port Mapper

ConfigurationDirectory

Broker instance directory (for example, /var/imq/instances/mybroker)

DirectoryName

Distinguished name of directory (for example, LDAP) entry where static information about application is stored

An empty string indicates that no information about the application is available in the directory.  

Port Mapper Information

The attributes shown in Table 21–4 provide information about a broker’s Port Mapper.

Table 21–4 JESMF-Accessible Message Queue Port Mapper Attributes

Attribute 

Description 

LabeledURI

URI for accessing Port Mapper, in the form

    mq://hostName:portNumber


Secured

Is Port Mapper access secure (SSL/TLS)?

Connection Service Information

Table 21–5 shows the JESMF-accessible attributes pertaining to each connection service.

Table 21–5 JESMF-Accessible Message Queue Connection Service Attributes

Attribute 

Description 

LabeledURI

URI for accessing connection service, in the form

    mq://hostName:portNumber/serviceName


if dynamically allocated, or  

    mqtcp://hostName:servicePort/serviceName


or  

    mqssl://hostName:servicePort/serviceName


if statically assigned 

Secured

Is connection service access secure (SSL/TLS)?

ConnectionsCount

Current number of connections 

NumConnectionsCreated

Cumulative number of connections created since broker started 

FailedConnectionsCount

Cumulative number of connections rejected since broker started 

CurrentNumberOfThreads

Current number of threads actively handling connections 

MinThreadPoolSize

Minimum number of threads maintained in connection service’s thread pool (broker property imq.serviceName.min_threads; see Table 16–1)

MaxThreadPoolSize

Number of threads beyond which no new threads are added to thread pool for use by connection service (broker property imq.serviceName.max_threads; see Table 16–1)

NumProducers

Current number of message producers 

NumConsumers

Current number of message consumers 

NumMsgsIn

Cumulative number of messages received since broker started 

NumMsgsOut

Cumulative number of messages sent since broker started 

InBytesCount

Cumulative size in bytes of messages received since broker started 

OutBytesCount

Cumulative size in bytes of messages sent since broker started 

NumPktsIn

Cumulative number of packets received since broker started 

NumPktsOut

Cumulative number of packets sent since broker started 

PktBytesIn

Cumulative size in bytes of packets received since broker started 

PktBytesOut

Cumulative size in bytes of packets sent since broker started 

Destination Information

Table 21–6 shows the JESMF-accessible attributes pertaining to each destination. Each of these attributes corresponds to a Message Queue physical destination property; see Table 17–1 for further information.

Table 21–6 JESMF-Accessible Message Queue Destination Attributes

Attribute 

Corresponding Property 

Description 

Type

 

Destination type (q = queue, t = topic)

MaxNumMsgs

maxNumMsgs

Maximum number of unconsumed messages 

MaxBytesPerMsg

maxBytesPerMsg

Maximum size, in bytes, of any single message 

MaxTotalMsgBytes

maxTotalMsgBytes

Maximum total memory, in bytes, for unconsumed messages 

LimitBehavior

limitBehavior

Broker behavior when memory-limit threshold reached 

MaxNumProducers [Does not apply to dead message queue]

maxNumProducers

Maximum number of associated message producers 

MaxNumActiveConsumers [Queue destinations only]

maxNumActiveConsumers

Maximum number of associated active message consumers in load-balanced delivery 

MaxNumBackupConsumers

maxNumBackupConsumers

Maximum number of associated backup message consumers in load-balanced delivery 

ConsumerFlowLimit

consumerFlowLimit

Maximum number of messages delivered to consumer in a single batch 

LocalOnly

isLocalOnly

Local delivery only?  

LocalDeliveryPreferred ,

localDeliveryPreferred

Local delivery preferred?  

UseDMQ

useDMQ

Send dead messages to dead message queue?

Persistent Store Information

The attributes shown in Table 21–7 pertain to the persistent data store.

Table 21–7 JESMF-Accessible Message Queue Persistent Store Attributes

Attribute 

Description 

AccessInfo

URL for accessing JDBC database

InfoFormat

Format of AccessInfo attribute (URL)

JDBCDriver

JDBC driver

UserName

User name for authentication 

User Repository Information

The attributes shown in Table 21–8 pertain to the LDAP user repository.

Table 21–8 JESMF-Accessible Message Queue User Repository Attributes

Attribute 

Description 

AccessInfo

URL for accessing LDAP server

InfoFormat

Format of AccessInfo attribute (URL)

Base

Root or base node for user lookup 

GroupBase

Root or base node for group lookup 

UserName

User name for authentication