Sun GlassFish Enterprise Server 2.1 Administration Reference

jms-availability

Enables availability in the Sun GlassFish Message Queue cluster that comprises the Java Message Service (JMS). Messages are saved to the HADB. The HADB must be installed and the enterprise profile must be selected. You must enable availability for Enterprise Server instances before you can enable availability for the corresponding Message Queue brokers.


Note –

Individual applications and modules cannot control or override JMS availability.



Note –

Some topics in the documentation pertain to features that are available only in domains that are configured to support clusters. Examples of domains that support clusters are domains that are created with the cluster profile or the enterprise profile. For information about profiles, see Usage Profiles in Sun GlassFish Enterprise Server 2.1 Administration Guide.


Superelements

availability-service

Subelements

The following table describes subelements for the jms-availability element.

Table 1–91 jms-availability Subelements

Element 

Required 

Description 

property

zero or more 

Specifies a property or a variable. 

Attributes

The following table describes attributes for the jms-availability element.

Table 1–92 jms-availability Attributes

Attribute 

Default 

Description 

availability-enabled

false

(optional) If set to true, and if availability is enabled for the Enterprise Server instance (see availability-service), high-availability is enabled for the Message Queue cluster associated with the Enterprise Server cluster. All instances in an Enterprise Server cluster should have the same availability settings to ensure consistent behavior.

mq-store-pool-name

availability-service store-pool-name attribute value

(optional) Specifies the jndi-name of the jdbc-resource used for connections to the HADB for the Message Queue cluster. Applicable if HADB is installed and you have selected the enterprise profile.

For more information about setting up a connection pool and JDBC resource for the HADB, see the description of the configure-ha-cluster command in the Sun GlassFish Enterprise Server 2.1 Reference Manual.