Use this task to configure a unified JMS connection factory for
applications that use the JMS 1.1 domain-independent (unified) interfaces.
Why and when to perform this task
A unified1 JMS connection factory can be used for both point-to-point
and publish/subscribe JMS messaging. With JMS 1.1, this approach is preferred
to the domain-specific queue connection factory and topic connection factory.
To
configure a JMS connection factory for the default messaging provider, use
the administrative console to complete the following steps. This task contains
an optional step for you to create a new connection factory if you have not
already created the connection factory that you want to configure.
Steps for this task
- Display the default messaging provider. In the navigation
pane, expand .
- Select the default provider for which you want to configure a unified
connection factory.
- Optional: Change the Scope check
box to set the level at which the connection factory is to be visible, according
to your needs.
- In the content pane, under the Additional properties heading, click Connection
factories. This displays any existing connection
factories in the content pane.
- If the connection factory is for use by client applications, display
the properties of the JMS connection factory. If you want to display
an existing JMS connection factory, click one of the names listed.
Alternatively,
if you want to create a new JMS connection factory, click New,
then specify the following required properties:
- Name
- Type the name by which the connection factory is known for administrative
purposes.
- JNDI name
- Type the JNDI name that is used to bind the connection factory into the
name space.
- Bus name
- Select the name of the service integration bus to
which the connection factory is to create connections. This service integration bus hosts
the destinations that the JMS queues and topics represent.
- Review the other properties for the JMS connection factory,
to check that the defaults are suitable. If needed, change the
values according to your needs.
If the connection factory is for use by
client applications running outside of an application server, you need to
specify suitable provider endpoints. For more information about configuring
provider endpoints, see Configuring a connection to a non-default bootstrap server.
By
default connections created using the connection factory in the server containers
(for example, from an enterprise bean) are pooled using J2C connection pooling.
You can modify the connection pool settings for the connection factory by
selecting the Connection pool properties link in the Additional
Properties section of the panel. For more information about changing the
connection pool properties, see Changing connection pool settings with the wsadmin
tool.
- Click OK.
- Save your changes to the master configuration.
1 The term
"unified" refers to the support of
both queues and topics by the same connection factory. This is similar to
the JMS 1.1 domain-independent interfaces (referred to as the
"common interfaces" in
the JMS specification).