This documentation is for WSO2 Enterprise Service Bus version 5.0.0. For the latest ESB, view the latest WSO2 Enterprise Integrator documentation.

All docs This doc

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Create a new directory named  wmq-client, and then create another new directory named lib inside it.
  2. Copy the following JAR files from the <IBM_MQ_HOME>/java/lib/ directory (where <IBM_MQ_HOME> refers to the IBM WebSphere MQ installation directory) to the wmq-client/lib/ directory.


    Note: If you are using IBM MQ 8 with Mutual SSL enabled, you need to download the file and follow the instructions in the readme.txt file.


    • fscontext.jar

    • jms.jar

    • providerutil.jar

  3. Create a POM.xml file inside the wmq-client/ directory and add all the required dependencies as shown in the example below.


    You need to change the values of the <version> and <systemPath> properties accordingly.

    Code Block
    <?xml version="1.0"?>
    <project xmlns="" xmlns:xsi="" xsi:schemaLocation="">
  4. Navigate to the wmq-client directory using your Command Line Interface (CLI), and execute the following command, to build the project: mvn clean install

  5. Stop the WSO2 ESB server, if it is already running. 

  6. Remove any existing IBM MQ client JAR files from the <ESB_HOME>/repository/components/dropins/ directory and the <ESB_HOME>/repository/components/lib/ directory.

  7. Copy the <wmq-client>/target/wmq-client- file to the <ESB_Home>/repository/components/dropins/ directory.

  8. Download the jta.jar file from the maven repository, and copy it to the <ESB_HOME>/repository/components/lib/ directory.

  9. Remove following line from the <ESB_HOME>/repository/conf/etc/launch.ini file: javax.jms,\
  10. Regenerate .bindings file with the Provider Version : 8 property (if you already generated one before), and replace the existing .bindings file (if you have one) with the new .bindings file you generated.

  11. Start the WSO2 ESB server.