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

Service Configuration

The service configuration MBean is used for configuring a connection service. There is one such MBean for each service.

Object Name

The service configuration MBean has an object name of the following form:

com.sun.messaging.jms.server:type=Service,subtype=Config,name=serviceName

where serviceName is the name of the connection service (see Table 3–7). The utility class MQObjectName provides a static method, createServiceConfig, for constructing object names of this form.

Table 3–7 Connection Service Names for Service Configuration MBeans

Service Name 

Service Type 

Protocol Type 

jms

Normal 

TCP

ssljms

Normal 

TLS (SSL-based security)

httpjms

Normal 

HTTP

httpsjms

Normal 

HTTPS (SSL-based security)

admin

Admin 

TCP

ssladmin

Admin 

TLS (SSL-based security)

Attributes

The service configuration MBean has the attributes shown in Table 3–8. The names of these attributes are defined as static constants in the utility class ServiceAttributes.

Table 3–8 Service Configuration Attributes

Name 

Type 

Settable? 

Description 

Name

String

No 

Service name 

See Table 3–7 for possible values.

Port

Integer

Yes 

Port number (jms, ssljms, admin, and ssladmin services only)

A value of 0 specifies that the port is to be dynamically allocated by the Port Mapper; to learn the actual port currently used by the service, use the Port attribute of the service monitor MBean.

MinThreads

Integer

Yes 

Minimum number of threads assigned to service 

Must be greater than 0.

MaxThreads

Integer

Yes 

Maximum number of threads assigned to service 

Must be greater than or equal to MinThreads.

ThreadPoolModel

String

No 

Threading model for thread pool management:  

    dedicated: Two dedicated threads per connection, one for incoming and one for outgoing messages


    shared: Connections processed by shared thread when sending or receiving messages (jms and admin services only)


Operations

The service configuration MBean supports the operations shown in Table 3–9. The names of these operations are defined as static constants in the utility class ServiceOperations.

Table 3–9 Service Configuration Operations

Name 

Parameters 

Result Type 

Description 

pause

None 

None 

Pause service (jms, ssljms, httpjms, and httpsjms services only)

resume

None 

None 

Resume service (jms, ssljms, httpjms, and httpsjms services only)

Notification

The service configuration MBean supports the notification shown in Table 3–10.

Table 3–10 Service Configuration Notification

Name 

Description 

jmx.attribute.change

Attribute value changed