Sun Java System Message Queue 3 2005Q4 Administration Guide |
Chapter 17
JMS Resource Adapter Property ReferenceThe Message Queue JMS Resource Adapter (JMS RA) enables you to integrate Sun Java System Message Queue with any J2EE 1.4 application server, by means of the standard J2EE connector architecture (JCA). When the Message Queue JMS Resource Adapter is plugged into an application server, an application deployed in that application server can use Message Queue to send and receive JMS messages.
The Message Queue JMS Resource Adapter exposes its configuration properties through three JavaBean components:
- ResourceAdapter configuration affects the behavior of the Resource Adapter as a whole.
- ManagedConnectionFactory configuration affects connections created by the Resource Adapter for use by message-driven beans (MDBs).
- ActivationSpec configuration affects message endpoints that represent message-driven beans MDBs in their interactions with the messaging system.
To set property values for these entities, you use the tools that your application server provides for configuration and deployment of the Resource Adapter and for deployment of MDBs.
This chapter lists and describes the configuration properties of the Message Queue JMS Resource Adapter. It contains the following sections:
ResourceAdapter JavaBeanThe ResourceAdapter configuration configures the default JMS Resource Adapter behavior. Table 17-1 lists and describes the properties with which you can configure this JavaBean. A footnote marks each required property.
Table 17-1 Resource Adapter Properties
Property
Default
Description
addressList1
mq://localhost:7676
/jmsThe connection that the Resource Adapter makes to the Message Queue service, specified using the message service address format.
The Resource Adapter supplies the default value.
This property name, addressList, is specific to Sun Java System Message Queue, but has the same meaning as the standard property connectionURL. Sun Java System Message Queue provides both property names. You must set either connectionURL or addressList; they are equivalent.
addressListBehavior
PRIORITY
A string specifying how the Resource Adapter connects to the Message Queue service. The value is PRIORITY or RANDOM.
A PRIORITY connection selects a Message Queue broker by choosing the first specified in the address list (addressList).
A RANDOM connection selects a Message Queue broker randomly from the address list.
Reconnection after a connection failure is the same for PRIORITY and RANDOM. A reconnection attempt starts with the broker whose connection failed. If that attempt is unsuccessful, the Resource Adapter proceeds sequentially through the active address list.
addressListIterations
1
The number of times to iterate through the address list. This value applies to the initial connection and to subsequent reconnection attempts.
connectionURL
mq://localhost:7676
/jms
The connection that the Resource Adapter makes to the Message Queue service, specified using the message service address format.
Equivalent to the addressList property; see description above for further details.
userName1
guest
The default user name with which the Resource Adapter connects to the Message Queue service.
The Resource Adapter supplies the default value.
password1
guest
The default password with which the Resource Adapter connects to the Message Queue service.
The Resource Adapter supplies the default value.
reconnectAttempts
6
The number of times to attempt reconnection to a single entry in the address list. This property is used when reconnectEnabled is set to true.
reconnectEnabled
false
A boolean value specifying whether to attempt reconnection after a connection failure.
The behavior of a reconnection attempt is governed by the values for reconnectInterval and reconnectAttempts.
reconnectInterval
30000
The interval between reconnection attempts, in milliseconds. This property is used when reconnectEnabled is set to true.
1This property is required.
ManagedConnectionFactory JavaBeanA managed connection factory provides and defines the connections that the Resource Adapter provides to a message-driven bean. If you set an attribute for which the ResourceAdapter JavaBean has an analogous property, the setting supersedes the analogous value specified for the ResourceAdapter bean.
Table 17-2 lists and describes the configurable attributes of a managed connection factory provided by the Message Queue Resource Adapter.
Table 17-2 Managed Connection Factory Attributes
Attribute
Default
Description
addressList
None
A list of connections derived from this managed connection factory.
The format of this attribute adheres to the Message Service addressList, as described in Table 17-1. If this value is not set, connections use the addressList value specified for the ResourceAdapter JavaBean and described in that table.
addressListBehavior
PRIORITY
A string specifying how the Resource Adapter connects to the Message Queue service. The value is PRIORITY or RANDOM.
A PRIORITY connection selects a Message Queue broker by choosing the first specified in the address list (addressList).
A RANDOM connection selects a Message Queue broker randomly from the address list.
Reconnection after a connection failure is the same for PRIORITY and RANDOM. A reconnection attempt starts with the broker whose connection failed. If that is unsuccessful, the connection attempts proceed sequentially through the active address list.
addressListIterations
1
The number of times to iterate through the address list. This value applies to the initial connection and to subsequent reconnection attempts.
clientID
None
The client identifier to use for connections derived from this managed connection factory.
password
guest
(Optional) The password for connections.
If this value is not set, connections use the password specified for the ResourceAdapter JavaBean, as described in Table 17-1.
reconnectAttempts
6
The number of times to attempt reconnection to a single entry in the address list.
reconnectEnabled
false
A boolean value specifying whether to attempt reconnection after failure of a connection or a new connection attempt.
The reconnection attempt is governed by the reconnectInterval and reconnectAttempts attributes.
reconnectInterval
30000
The minimum number of milliseconds to wait between attempts to reconnect to the Message Queue service.
userName
guest
(Optional) The user name for connections.
If this value is not set, connections use the user name specified for the ResourceAdapter JavaBean, as described in Table 17-1.
ActivationSpec JavaBeanActivationSpec JavaBean properties are used by the application server when it instructs the Resource Adapter to activate a message endpoint and associate the message endpoint with a message-driven bean.
Table 17-3 lists and describes the configurable properties for a message endpoint activation specification. The table indicates the properties that are specific to the Message Queue Resource Adapter and the properties that are specific to the Enterprise JavaBean 2.1 standard or J2EE Connector Architecture (J2EE CA) 1.5 standard.