Skip to main content

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

More about Connect MQ rules

Updated on April 6, 2022

Important: Connect MQ rules are no longer being actively developed. To avoid upgrade issues when these rules are deprecated, use JMS Connectors instead. For more information about JMS connectors, see Connect JMS rules.

If you configured an alias queue for Connect MQ rules in earlier versions of Pega Platform, after a upgrade to Pega Platform 8.6, Connect MQ rules do not work. To resolve this issue, create the following dynamic system settings and set the corresponding default values:

  • "mq/pmo" = 0
  • "mq/gmo" = 0
  • "mq/oo_request" = 1040
  • "mq/oo_response" = 16

For more information, see Creating a dynamic system setting.

Calling activity

To start an MQ connection and execute a Connect MQ rule, create an activity that:

  1. Creates a named page that is the source and destination of data mapping.
  2. Opens the Connect MQ rule on a named page of a Rule-Connect-MQ class.
  3. Using that page as a step page, uses the Connect-MQ method.
  4. Checks the status values returned.

If this activity is in a class derived from the Work- base class, you can set the Activity Type to Rule Connect and reference the activity in a flow rule.

Performance Statistics

For information on gathering performance information about this connector see Testing Services and Connectors on Pega Community.


While testing Connect MQ rules, you can view the request queue and the response queue. Click the Open icon next to the Request queue name or Response queue name on the Service tab, to start the MQ Explorer. You can also start the MQ Explorer from the Queue name fields on the MQ Properties tab of the MQ Listener form, or from the MQ Explorer button on the Environment tab of the MQ Server form.

For an example, see the Pega Community article How to debug MQ connectors using BROWSE, PUT and GET message operations.

Simulation and testing

To debug your application, you can simulate an MQ connector when the external system is unavailable or lacks a test environment.

For more information on testing connectors, see Testing Services and Connectors on the Pega Community.

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