Use this task to view or change the configuration of an
existing JMS queue connection factory for point-to-point messaging
with the WebSphere® MQ messaging provider.
Before you begin
With JMS 1.1, domain-independent (unified) connection factories
are preferred to domain-specific queue connection factories and topic
connection factories. To configure a unified connection factories,
see the related tasks.
About this task
To view or change the configuration of an existing queue
connection factory for use with the WebSphere MQ
messaging provider, use the administrative console to complete the
following steps.
Procedure
- In the navigation pane, click .
A list of existing queue connection factories, with a
summary of their properties, is displayed in a Queue connection factory collection form.
- Select the Scope setting corresponding
to the scope at which the queue connection factory is visible to applications.
- Click the name of the queue connection factory that you
want to view or change. Configuration details for
the queue connection factory are displayed in a WebSphere MQ messaging provider queue connection factory settings form.
- Under General Properties make modifications
as necessary.
For information about each of the available
fields, see the WebSphere MQ messaging provider queue connection factory settings form.
Restriction: Before Fix Pack 5, if this connection factory is used to connect to a queue manager or queue-sharing group on a WebSphere MQ for z/OS system, enter the value 6.0.0.0 in the Provider version property. The connection factory must use this provider version value regardless of the version of WebSphere MQ for z/OS to which it connects. The Provider version property is in the Advanced section of the General Properties.
For Fix Pack 5 or later, if this connection factory is used to connect to a queue manager or queue-sharing group on a WebSphere MQ for z/OS Version 7 system, enter the value 6.0.0.0 in the Provider version property.
For Fix Pack 7 or later, the restriction on the provider version is lifted.
- Click Apply to save the configuration.
- Optional: Click Advanced properties to
display or change the list of advanced properties of your queue connection
factory.
- Optional: Click Custom properties to
display or change the list of custom properties of your queue connection
factory.
- Optional: Click Client transport
properties to display or change the list of client transport
properties of your queue connection factory. This link is only present
on the explicitly-defined variation of this panel, where you enter
all information required to connect to WebSphere MQ.
This link does not appear for the CCDT-based variation.
- Optional: Click Connection pools to
display or change the connection pools detail of your queue connection
factory.
- Optional: Click Session pools to
display or change the session pools detail of your queue connection
factory.
There is a mechanism (session.sharing.scope custom property)
to make JMS sessions unshareable. This means that whenever an application
calls Session.close(), the JMS session is automatically released from
any transaction that is associated with and returned to the session
pool. This means that sessions can be cleaned up and removed from
the session pool even if the servlet or asynchronous bean that created
it is still running.
- Click OK.
- Save your changes to the master configuration.
- To have the changed configuration take effect, stop then
restart the application server.