Table of Contents

More about Connect MQ rules

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 About 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.

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.