Use this task to browse or change a JMS queue connection factory for use with WebSphere MQ as a messaging provider. This task contains an optional step for you to create a new JMS queue connection factory.

Why and when to perform this task

With JMS 1.1, the preferred approach is to use unified JMS connection factories instead of the domain-specific JMS queue connection factory and JMS topic connection factory. If you want to configure a unified JMS connection factory, see Configuring a unified JMS connection factory, for WebSphere MQ.

To browse or configure a JMS queue connection factory for use with WebSphere MQ as a messaging provider, use the administrative console to complete the following steps:

1. Display the WebSphere MQ messaging provider. In the navigation pane, expand Resources > JMS Providers > WebSphere MQ .

2. Optional: Change the Scope setting to the level at which the connection factory is visible to applications.

3. In the contents pane, under Additional Properties, click WebSphere MQ Queue Connection Factories This displays a table listing any existing JMS queue connection factories, with a summary of their properties.

4. To browse or change an existing JMS queue connection factory, click its name in the list. Otherwise, to create a new connection factory, complete the following steps:

   1. Click New in the content pane.

   2. Specify the following required properties. You can specify other properties, as described in a later step.

      Name

      The name by which this connection factory is known for administrative purposes within IBM WebSphere Application Server.

      JNDI name

      The JNDI name that is used to bind the connection factory into the name space.

      CCSID

      The coded character set identifier for use with the WebSphere MQ queue manager; for example: 850.

   3. Click Apply . This defines the connection factory to WebSphere Application Server, and enables you to browse or change additional properties.

5. Optional: Change properties for the queue connection factory, according to your needs.

6. Optional: Change connection pool properties and session pool properties, according to your needs.

7. Click OK .

8. Save any changes to the master configuration.

9. To have the changed configuration take effect, stop then restart the application server.

Related tasks
Configuring a JMS queue destination, for WebSphere MQ
Configuring JMS resources for the WebSphere MQ messaging provider

Related reference
WebSphere MQ queue connection factory settings