Configuring a queue connection factory for the WebSphere MQ messaging provider

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

  1. In the navigation pane, click Resources > JMS > Queue connection factories . A list of existing queue connection factories, with a summary of their properties, is displayed in a Queue connection factory collection form.
  2. Select the Scope setting corresponding to the scope at which the queue connection factory is visible to applications.
  3. 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.
  4. 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.

    [Fix Pack 5 or later] 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.

    [Fix Pack 7 or later] For Fix Pack 7 or later, the restriction on the provider version is lifted.

  5. Click Apply to save the configuration.
  6. Optional: Click Advanced properties to display or change the list of advanced properties of your queue connection factory.
  7. Optional: Click Custom properties to display or change the list of custom properties of your queue connection factory.
  8. 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.
  9. Optional: Click Connection pools to display or change the connection pools detail of your queue connection factory.
  10. 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.

  11. Click OK.
  12. Save your changes to the master configuration.
  13. To have the changed configuration take effect, stop then restart the application server.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 20, 2010 11:50:58 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-base-iseries&topic=tmj_adm25
File name: tmj_adm25.html