Skip to main content

Support Article

Integrate Tomcat with WebSphere IBM MQ



The requirement is to integrate Tomcat with IBM WebSphere Message Queue (MQ).

Error Messages

Not Applicable

Steps to Reproduce

Not Applicable

Root Cause

Not Applicable


Perform the following steps to integrate Tomcat with WebSphere IBM MQ:
  1. Define MQ JMS (Java Message Service) Administered objects such as Queue Connection Factory, Queue, etc. The MQ Explorer is the tool provided by IBM.
  2. Copy the resulting .bindings file to a location on the Tomcat server. For example, /ibmjmsbindings.
  3. Copy the following JAR files from the IBM MQ Java client to the Tomcat LIB directory:

    – fscontext.jar
    – jms.jar
    – providerutil.jar

    4. After restarting the Tomcat Pega instance, define the Java Naming and Directory Interface (JNDI) server (from the Pega Developer Portal) with the following values:

    – Initial Context Factory: 
    – Provider URL (Unix example assuming the .bindings file is under /ibmjmsbindings): file:///ibmjmsbindings


Suggest Edit

Published August 24, 2018 - Updated March 13, 2019

Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us