Sun GlassFish Enterprise Server v3 Domain File Format Reference

Attributes

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

Table 1–86 jms-service Attributes

Attribute 

Default 

Description 

init-timeout-in-seconds

60

(optional) Specifies the amount of time the server instance waits at startup for its configured default JMS host to respond. If there is no response, startup is aborted. If set to 0, the server instance waits indefinitely.

type

EMBEDDED

Specifies the type of JMS service: 

  • EMBEDDED means the JMS provider is started in the same JVM machine as the Enterprise Server, and the networking stack is bypassed.

    Lazy initialization starts the default embedded broker on the first access of JMS services rather than at Enterprise Server startup.

  • LOCAL means the JMS provider is started along with the Enterprise Server.

    The LOCAL setting implicitly sets up a 1:1 relationship between an Enterprise Server instance and a Message Queue broker.

  • REMOTE means the JMS provider is remote and is not started by the Enterprise Server.

start-args

none 

(optional) Specifies the string of arguments supplied for startup of the corresponding JMS instance. 

default-jms-host

none 

Specifies the name of the default jms-host. If type is set to LOCAL, this jms-host is automatically started at Enterprise Server startup.

reconnect-interval-in-seconds

5

(optional) Specifies the interval between reconnect attempts. 

reconnect-attempts

3

(optional) Specifies the number of reconnect attempts. 

reconnect-enabled

true

(optional) If true, reconnection is enabled. The JMS service automatically tries to reconnect to the JMS provider when the connection is broken.

When the connection is broken, depending on the message processing stage, the onMessage() method might not be able to complete successfully or the transaction might be rolled back due to a JMS exception. When the JMS service reestablishes the connection, JMS message redelivery semantics apply.

addresslist-behavior

random

(optional) Specifies whether the reconnection logic selects the broker from the imqAddressList in a random or sequential (priority) fashion.

addresslist-iterations

3

(optional) Specifies the number of times the reconnection logic iterates over the imqAddressList if addresslist-behavior is set to PRIORITY.

mq-scheme

mq

(optional) Specifies the scheme for establishing connection with the broker. For example, specify http for connecting to the broker over HTTP.

mq-service

jms

(optional) Specifies the type of broker service. If a broker supports SSL, the type of service can be ssljms.