Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Service MQ rules

Updated on August 10, 2022

Use a package of Service MQ rules to let external systems and users access the Pega Platform data and processing using the IBM WebSphere MQ middleware messaging standard. Each Service MQ rule identifies an activity providing the service. The external system passes an MQ message to the Pega Platform, which runs the activity and then may return an output MQ message.

Pega supports Websphere MQ versions up to and including version 9.

When the Pega Platform is deployed as an enterprise application, you must use a message-driven bean (MDB) as the listener for message-based service rules (JMS and MQ). As a result, although you can use WebSphere MQ as a JMS service provider, use JMS MDB listeners with JMS service rules, rather than MQ listeners with MQ service rules, when the Pega Platform is deployed as an enterprise application.

MQ services generally process service requests synchronously. That is, they immediately perform the requested processing and return a configured response while the calling application waits. However, you can configure MQ services to process service requests asynchronously, which means the service queues the request for asynchronous execution and the calling application calls back later for the results. Additionally, you can configure synchronous MQ services to check for specific error conditions that you expect will be temporary — work item locks, for example — and then queue service requests that fail for those reasons for another attempt at a later time.

For information about creating MQ services, see the following Pega Community articles:

  • How asynchronous service processing works
  • Configure a service to process requests asynchronously
  • Configure a service to queue a failed service request for another attempt


Use the Application Explorer to see Service MQ rules in your application. Use the Records Explorer to list all Service MQ rules that are available to you.


Service MQ rules belong to the Integration-Services category. A Service MQ rule is an instance of the Rule-Service-MQ rule type.

  • Previous topic Unit testing a Service JSR 94 rule
  • Next topic Service MQ rules - Completing the Create, Save As, or Specialization form

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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