Creating an IBM MQ messaging provider queue connection factory

To create an IBM MQ messaging provider queue connection factory, follow this procedure on the WebSphere Commerce 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:
    OptionDescription
    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 Configuring 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:
    OptionDescription
    Transport
    • If WebSphere Commerce and IBM MQ are installed on the same machine and you want to use bindings mode, choose BINDINGS.
    • If you have IBM MQ installed on the WebSphere Commerce machine, and you 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
    Bindings mode
    Ensure that this field is cleared.
    Client mode
    Enter the listener port number for the queue manager you created in Configuring IBM MQ for use with WebSphere Commerce.
    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. For more information, see Determining the maximum number of connections allowed for the Adapter for IBM MQ.