Create an IBM MQ messaging provider queue connection factory

To create an IBM MQ messaging provider queue connection factory, follow this procedure on the Transaction Server.


Procedure

  1. In the WebSphere Application Server administrative console navigation tree, expand Resources and select JMS then Queue connection factories.

  2. Select the scope of the queue connection factory from the list. Use the node value WC_instance_name, where instance_name is the name of the WebSphere Commerce instance. Create it under the scope of Node=WC_instance name_node, Server=server1 level. Click New.

  3. Select IBM MQ messaging provider and click OK.

  4. Configure basic attributes with the following values:

    Option Description
    Name JMSQueueConnectionFactory
    JNDI Name JMSQueueConnectionFactory
    Optional: Description JMSQueueConnectionFactory

    Click Next.

  5. Select Enter all the required information into this wizard and click Next.

  6. Enter the name of the queue manager identified or created in Configure IBM MQ for use with WebSphere Commerce, and then click Next. For example, hostname.qm, where hostname is the host name (without the domain) for the machine running IBM MQ.

  7. Enter the connection details:

    Option Description
    Transport

    • If WebSphere Commerce and IBM MQ are installed on the same machine and we want to use bindings mode, choose BINDINGS.

    • If you have IBM MQ installed on the WebSphere Commerce machine, and we want to use client mode, choose CLIENT.

    Hostname

      Bindings mode
      Ensure that this field is cleared.

      Client mode
      Enter the fully qualified TCP/IP host name of the IBM MQ server.

    Port

    Server connection channel

      Bindings mode
      Ensure that this field is cleared.

      Client mode
      Ignore this field.

    Click Next.

  8. Click Test connection. Confirm the connection results and click Next. View the summary, and then click Finish. If you receive an error during the test, see Troubleshooting: Connection to IBM MQ queue manager fails.

  9. Select the newly created JMSQueueConnectionFactory.

  10. Under Advanced, clear Support distributed two phase commit protocol. Click Apply.

  11. Under Additional properties, click Advanced properties.

  12. Under connection consumer, clear Retain messages, even if no matching consumer is available. Click OK.

  13. Under Additional properties, click Connection pool.

  14. Adjust the maximum number of connections needed. This number must be 1 greater than the number defined under the WC_instance_name enterprise application. Click OK and save the configuration. Click Save in the administrative console task bar. On the Save page, click Save. See Determining the maximum number of connections allowed for the Adapter for IBM MQ.

Previous topic: Determining the maximum number of connections allowed for the Adapter for IBM MQ
Next topic: Creating IBM MQ messaging provider queue destinations