The URL Syntax of a Horizontal Scalability Connection Factory

Horizontal scalability connection factories enable clients to publish messages to a set of servers or consume messages from a set of servers in a round-robin manner. The following rules apply to the round-robin URL syntax:

Each connection URL must be enclosed in round brackets.

Each set of brackets must contain at least one valid connection URL.

There is no limit to the number of sets of brackets in the URL.

Each set of brackets indicates a unique connection, and the realm names in each set of brackets are supplied unchanged to the underlying implementation.

Consider the following examples:

(UM1)(UM2)(UM3)(UM4) - Indicates four standalone realms, UM1, UM2, UM3, and UM4, so four connections will be constructed here.

(UM1,UM2)(UM3,UM4) - Indicates two clusters, one consisting of UM1 and UM2, and the other consisting of UM3 and UM4, so only two connections will be constructed here.

(UM1)(UM2,UM3)(UM4) - Indicates one cluster consisting of UM2 and UM3, and two standalone realms: UM1 and UM4. A total of three connections will be constructed here.

Note:
Round-robin delivery is not supported for XA connection factories.

For more information about horizontal scalability connection factories, see Overview of the Provider for JMS in the Developer Guide.