Skip to main content

Configuring enterprise messaging using IBM MQ

Suggest edit Updated on December 1, 2021

Pega Platform supports using IBM messaging queues (MQ) in your Pega applications running in Pega Cloud services environments.

Before you begin:

To configure enterprise messaging for a Pega Platform environment, you must ensure the following conditions:

  • IBM MQ servers must be available and accessible from your Pega Platform environment, and you must identify the topics and queues to use. If these servers are not available, you can create mock environments to facilitate integration with your application.
  • The IBM MQ servers must be secure and you must configure the required authentication information for using the servers.
  • You must install the appropriate Java client libraries installed onto the Pega Platform environment. Verify that you import the correct JAR files and that you have all of the requisite licenses. You may need to restart your system for the libraries to load correctly. For more information about the Java client libraries to install, see the IBM MQ documentation.

The information here applies to software running both in Pega Cloud and on-premises applications.

Pega Platform supports asynchronous messaging integration configurations using IBM WebSphere MQ (IBM MQ). IBM MQ asynchronous messaging configurations are useful for Pega Cloud applications when REST or SOAP connectivity is not suitable for your application environment.

For asynchronous messaging integration configurations on your systems, Pega Cloud clients are solely responsible for any applications or software that you import into your Pega Cloud services environment, including libraries and requisite licenses: if you import incorrect files or unauthorized software and negatively affect your Pega Cloud services environment, this can result in system downtime and require you to work with Pegasystems Global Customer Support to restore your environment.

Pega Platform has proven interoperability with IBM MQ Version 9 or later.

Configuring messaging with IBM MQ
  1. Configure connectivity to your IBM MQ server. For more information, see About MQ rules.

  2. Ensure that your connectors are secure for the type of integration and for the data that is being transmitted. Security measures include the following items:

    • Using a secure tunnel to provide data transport encryption. You can create a secure tunnel by using one of the following methods:
  3. Verify that your Pega Platform application is configured with the appropriate access groups, roles, and privileges. For more information, see Authorization.

Did you find this content helpful? YesNo

100% found this useful

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us