Skip to main content

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

Connect-MQ method

Updated on August 16, 2022

Use the Connect-MQ method to invoke a connector to an external system that uses IBM WebSphere MQ messaging services.


This method operates on a named clipboard page that is the source and destination of data mappings. Make sure the Step Page column that calls this method contains the non-blank name of such a page.

This method has two parameters:

ServiceName Enter the Service Name (second key part) of a Connect MQ rule ( Rule-Connect-MQ rule type). The system uses the class of the step page as the first key part of the rule.
RunInParallelSelect if this connector is intended to run in parallel as a child requestor of the current requestor. If selected, use the Connect-Wait method later in the current or a follow-on activity to access results from the connector.


The Connect-MQ method works as follows:

  1. Using rule resolution, locates the Connect MQ rule identified by the ServiceName parameter and the class of the step page or primary page.
  2. Uses request information in the Connect MQ rule to assemble an MQ request message.
  3. If the step page does not exist, creates a new page, of the class identified in the Pages & Classes tab.
  4. Checks whether simulation is in force for this rule. If so, calls the simulation stub activity.
  5. If simulation is not in force, sends the MQ message, in a separate thread if the RunInParallel box is selected. (This temporary requestor has the same access group and clipboard as the original.) If the limit of parallel requestors is then eventually reached, the parent requestor will fail as well. By default, the limit is 10 requestors in parallel; you can establish a higher or lower value in the prconfig.xml file or dynamic system settings using the services/maxRequestorChildren setting.
  6. Processes the MQ response message if any when it is received.

Checking the method status

This method updates the pxMethodStatus property. See How to test method results using a transition.

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