3.11.39 /resources/connector-connection-pool/property
/resources/connector-connection-pool/property specifies a property or a variable.
Description
/resources/connector-connection-pool/property specifies the name and value of a property.
This element can be used to overwrite the setting value retained by the ManagedConnectionFactory class based on the JavaBeans specifications.
Specify the property name according to the JavaBeans specifications that corresponds to "setter" method of the ManagedConnectionFactory class specified in the managedconnectionfactory-class element of the ra.xml file.
If the same property is set to this element and the config-property element of ra.xml, this element takes priority.
Repetition pattern
0 or more times
Specifiable attributes
Attribute name |
Description |
Specifiable values |
Default value# |
Dependencies |
Repetition pattern |
|---|---|---|---|---|---|
name |
Specify the property name of "Specifiable properties". |
Type: String |
No default value |
N/A |
Only one time |
value |
Specify the value of "Specifiable properties" (specifiable value). |
Type: String |
No default value |
N/A |
Only one time |
- Legend:
N/A: Not applicable
#: This is the default value that is set when a definition item is excluded.
Specifiable properties
The following properties can be specified for "Specifiable attributes":
Property name |
Description |
Specifiable values |
Default value# |
Dependencies |
Repetition pattern |
|---|---|---|---|---|---|
AddressList |
Specifies a list of host/port combinations of the Message Queue software. For JMS resources of the type, specify javax.jms.TopicConnectionFactory or javax.jms.QueueConnectionFactory. |
Type: String |
No default value |
N/A |
Only one time |
ClientId |
Specifies the JMS Client Identifier to be associated with a connection created using the createTopicConnection method of the TopicConnectionFactory class. For JMS resources of the type javax.jms.TopicConnectionFactory, durable subscription names are unique and valid only within the scope of a client identifier. To create or reactivate a durable subscriber, the connection must have a valid client identifier. The JMS specification ensures that the client identifiers are unique and that the given client identifier is allowed to be used by only one active connection at a time. |
Type: String |
No default value |
N/A |
Only one time |
UserName |
Specifies the user name used to connect to the Message Queue software. This property is used for JMS resources of the type javax.jms.TopicConnectionFactory or javax.jms.QueueConnectionFactory. |
Type: String |
guest |
N/A |
Only one time |
Password |
Specifies the password to connect to the Message Queue software. This property is used for JMS resources of the type javax.jms.TopicConnectionFactory or javax.jms.QueueConnectionFactory. |
Type: String |
guest |
N/A |
Only one time |
ReconnectAttempts |
Specifies the number of attempts to connect (or reconnect) for each address in the imqAddressList before the client runtime moves on to try the next address in the list. A value of -1 indicates that the number of reconnect attempts is unlimited (the client runtime attempts to connect to the first address until it succeeds). |
Type: Integer -1 to 2147483647 |
6 |
N/A |
Only one time |
ReconnectInterval |
Specifies the interval between reconnect attempts in milliseconds. This applies to attempts on each address in the imqAddressList and on successive addresses in the list. If too short, this time interval does not give a broker time to recover. If too long, the reconnect might represent an unacceptable delay. |
Type: Integer 1 to 2147483647 |
30000 |
N/A |
Only one time |
ReconnectEnabled |
If true, specifies that the client runtime attempts to reconnect to the message server (or the list of addresses specified in imqAddressList) when a connection is lost. |
Type: Boolean {true | false} |
false |
N/A |
Only one time |
AddressListBehavior |
Specifies whether connection attempts are in the order of addresses in the imqAddressList attribute (priority) or in a random order (random). If many clients are attempting a connection using the same connection factory, use a random order to prevent them from all being connected to the same address. The following values can be specified: PRIORITY To enable the parallel-broker reconnection, set the imqAddressListBehavior attribute to PRIORITY. Specify no more than a pair of brokers for this type of reconnection. In this way, the messages are published to one broker and all the clients fail together from the first broker to the second. RANDOM To enable the clustered-broker reconnection, set the imqAddressListBehavior attribute to RANDOM. In this way, the client runtime randomizes the connection attempts across the list and the client connections are distributed evenly across the broker cluster. |
Type: String {priority | random} |
priority |
N/A |
Only one time |
AddressListIterations |
Specifies the number of times the client runtime iterates through the imqAddressList in an effort to establish (or reestablish) a connection. A value of -1 indicates that the number of attempts is unlimited |
Type: Integer -1 to 2147483647 |
-1 |
N/A |
Only one time |
- Legend:
N/A: Not applicable
#: This is the default value that is set when a definition item is excluded.