Creating a connection factory for the WebSphere MQ messaging provider

Use this task to create a connection factory, a queue connection factory, or a topic connection factory for use with the WebSphere® MQ messaging provider.

About this task

With JMS 1.1, domain-independent connection factories are preferred to domain-specific queue connection factories and topic connection factories.

To create a connection factory, a queue connection factory, or a topic connection factory for use with the WebSphere MQ messaging provider, use the administrative console to complete the following steps. You can choose either to enter all the required connection information using the Create WebSphere MQ JMS resource wizard or to use a client channel definition table (CCDT) to establish a connection to the WebSphere MQ messaging provider.

For information about modifying an existing connection factory, see the related tasks.

Procedure

  1. In the navigation pane, select the type of connection factory you want to create:
    • To create a connection factory, click Resources > JMS ->Connection factories.
    • To create a queue connection factory, click Resources > JMS ->Queue connection factories.
    • To create a topic connection factory, click Resources > JMS ->Topic connection factories.
  2. Select the Scope setting corresponding to the scope of the connection factory that you want to create.
  3. Click New in the content pane to start the Create WebSphere MQ JMS resource wizard.
  4. Select WebSphere MQ messaging provider, then click OK.
  5. On the "Configure basic attributes" page, specify the following properties, then click Next.
    Name
    The name by which this connection factory is known for administrative purposes within WebSphere Application Server.
    JNDI name
    The name that is used to bind this connection factory into the Java Naming and Directory Interface (JNDI) namespace.
    Description
    Optional. A description of this connection factory for administrative purposes within WebSphere Application Server.
  6. On the "Select connection method" page, choose how you want to specify the connection details for to the WebSphere MQ messaging provider by selecting one of the following options, then click Next.
    Enter all the required information into this wizard
    Choosing this option takes you to the "Supply queue manager details" page (see step 7), where you can start entering the connection details using the Create WebSphere MQ JMS resource wizard.
    Use a client channel definition table
    Choosing this option takes you to the "Specify client channel definition table" page (see step 8), where you can enter details of the client channel definition table that you want to use.
  7. If you have chosen to enter all the required information using the wizard, complete the following steps:
    1. On the "Supply queue manager details" page, enter the name of the queue manager or queue-sharing group that you want to connect to then click Next.
    2. On the "Enter connection details" page, specify the details for the connection, then click Next to continue to the "Test connection" page.
      Transport
      Optional. The WebSphere MQ transport type for the connection. The option that you select is used to determine the exact mechanisms used to connect to WebSphere MQ. If you are configuring a transport type of bindings, then client or bindings, refer to Configuring the WebSphere MQ messaging provider with native libraries information and Sizing the thread pools used by the WebSphere MQ messaging provider for more information.

      [Fix Pack 5 or later] The information about sizing the thread pools used by the WebSphere MQ messaging provider is not relevant for Fix Pack 5 or later since the WMQCommonServices thread pool is no longer used.

      Hostname
      The host name, IPv4, or IPv6 address of the WebSphere MQ queue manager to connect to. Complete this field if you have selected Enter host and port information in the form of separate hostname and port values.
      Port
      Optional. The port number on which WebSphere MQ is listening. Complete this field if you have selected Enter host and port information in the form of separate hostname and port values.
      Server connection channel
      Optional. The WebSphere MQ server connection channel name used when connecting to WebSphere MQ queue manager or queue-sharing group.
  8. If you are using a channel client definition table to establish a connection to the WebSphere MQ messaging provider, complete the following fields on the "Specify client channel definition table" page, then click Next to continue to the "Test connection" page.
    Client channel definition table URL
    The URL to the client channel definition table that you want to use when connecting to WebSphere MQ.
    Queue manager
    Optional. The name of the queue manager to be used to select one or more entries from the CCDT.
  9. Optional: On the "Test connection" page, if you want to test establishing the connection, click Test connection. This test can take several seconds to perform.
  10. On the "Summary" page, complete the creation of the new connection factory by clicking Finish.
  11. 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 Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 8:40:09 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=tmj_adm30
File name: tmj_adm30.html