Skip to main content


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

Connect MQ form - Completing the Service tab

Updated on April 6, 2022

Use the Service tab to identify the location, port, and other properties of the WebSphere MQ server. After you complete this tab and save the Connect MQ form, you can test connectivity to the MQ server.

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

MQ Server

FieldDescription
MQ server nameIdentify an MQ Server, an instance of the Data-Admin-Connect-MQServer class. Pega Platform uses this information to find and log into the remote WebSphere MQ system.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyMQServerKey. For more information, see Using the Global Resource Settings feature.

Request

FieldDescription
Request queue managerOptional. Enter the name of the queue manager. If you leave this field blank, the system uses the default queue manager for the specified queue.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyMQRequestQueueManager. For more information, see Using the Global Resource Settings feature.

Click the Open icon button to inspect the queue. A window appears, listing any items in the queue. Click a message position number to display detailed information about that item.

Request queue nameEnter the name of the queue onto which the outgoing request message is to be placed.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyMQRequestQueueName. For more information, see Using the Global Resource Settings feature.

Click View Request Queue to display a list of MQ messages, add or remove a message. For an example, see the Pega Community article How to debug MQ connectors using BROWSE, PUT and GET message operations.

Resolved queue name propertyOptional. Select a Single Value property to indicate that the queue manager is to return the local name of the request queue on which the message was put. The value is then stored in this property. The value may differ from the queue specified in the Request queue name field if the specified queue is an alias, remote, or model queue.

This is option ResolvedQName in the PUT message.

Resolved queue manager propertyOptional. Select a Single Value property to indicate that the queue manager is to return the local name of the queue manager of the queue on which the message was put. The value is then stored in this property.

The value may differ from the manager specified in the Request queue manager field if the queue specified in the Request queue name field is a remote queue.

This is option ResolvedQMgrName in the PUT message.

Response

FieldDescription
Response message IDSelect how the receiving application is to determine the MessageID header value for its response message at runtime. Select:
  • Generate Unique Value — At runtime, the queue manager of the response queue generates a unique value for each response message.
  • Pass Value From Request — The receiving application copies the value from the MessageID header in the request message to the MessageID header in the response message.

Click the Open icon to inspect the queue. A window appears, listing any items in the queue. Click a message position number to display detailed information about that item.

Response correlation IDSelect how the receiving application determines the CorrelationID header value for its message at runtime:
  • Copy Request Message ID — The receiving application copies the value from the MessageID header in the request message to the CorrelationID header in the response message.
  • Pass Value From Request — The receiving application copies the value of the CorrelationID in the request message to the CorrelationID header in the response message.
Dynamic queueSelect to specify that a dynamic local queue is to be created for the responses to the messages sent by this connector.

When this option is selected, Pega Platform obtains a dynamic local queue from the Request Queue Manager and places the identity of that dynamic queue in the Reply to queue field in the message headers of the messages sent by this connector. Responses to the messages are then posted to the dynamic queue.

If you select this box, complete the Model name field and the Response tab.

Dynamic queue close optionsPega Platform closes the dynamic queue after it retrieves the response message from it. Select one of the following options to specify how Pega Platform is to close the dynamic queue:
  • MQCO_NONE — Close the dynamic queue with no additional processing.
  • MQCO_DELETE — If there are no pending updates to the queue and there are no messages left on it, delete it.
  • MQCO_DELETE_PURGE — If there are no pending updates to the queue, delete any existing messages and then delete the message.

If the model specified in the Response queue model name field defines temporary rather than permanent dynamic queues, the MQCO_CLOSE option is the only valid option. In this case, if you select either MQCO_DELETE or MQCO_DELETE_PURGE, it is interpreted at runtime as MQCO_CLOSE.

Response queue / model nameDo one of the following:
  • If the Dynamic queue option is not selected, enter the name of the queue from which the system retrieves the incoming response message.
  • If the Dynamic queue option is selected, enter the name of the model queue that the Request Queue Manager is to use to create dynamic queues for this connector.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyMQResponseQueueName. For more information, see Using the Global Resource Settings feature.

Click View Response Queue to display a list of MQ messages, add a message, or remove a message. For an example, see the Pega Community article How to debug MQ connectors using BROWSE, PUT and GET message operations.

Response queue managerOptional. Enter the name of the queue manager. If you leave this field blank, the system uses the default queue manager for the specified queue.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyMQResponseQueueManager. For more information, see Using the Global Resource Settings feature.

Resolved queue name propertyOptional. Select a Single Value property to indicate that the queue manager is to return the local name of the queue from which the message was retrieved. The value is then stored in this property. The value may be different than the queue specified in the Response queue name field if the specified queue an alias or model queue.
Response message timeoutOptional. Enter the number of seconds that the activity calling the service is to wait for a response. If Pega Platform does not receive a response within this time interval, it reports a service failure and activity processing continues.

If you leave this field blank, the calling activity waits indefinitely for a response message.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyMQResponseTimeout. For more information, see Using the Global Resource Settings feature.

Reports

FieldDescription
ReportsOptional. Select these boxes to identify the WebSphere MQ report message types that the remote application creates after it places a message on a queue. These report messages supersede or are in addition to the standard reply message:
  • Exception — The remote application sends a report when an error occurs during processing of the request message. Because an exception report represents a processing error, it supersedes the standard reply message.
  • Expiration — The remote application sends a report when the request message is not removed from the queue by the receiving application within the time period specified by the Expiry header field of the request message. Because an expiration report represents a processing error, it supersedes the standard reply message.
  • Confirm on Arrival — The remote application sends a report when the request message is placed on the queue. It sends Confirm on Arrival (COA) reports in addition to the standard reply message.
  • Confirm on Delivery — The remote application sends a report when the request message is removed from the queue by the receiving application. It sends Confirm on Delivery (COD) reports in addition to the standard reply message.
Page nameOptional. For each report you selected, enter the name of a clipboard page that Pega Platform creates to hold the data contained in the report. The class of these pages is Data-MQMessage.
DataFor each report selected, specify the size of the data buffer for the report message:
  • No Data — The data buffer is empty.
  • Partial Data — The data buffer is no more than 100 bytes.
  • Full Data — The data buffer size is unlimited.

Error handling

FieldDescription
Status value propertyOptional. Select a Single Value property that the system uses to report the status of the remote service request. The value is one of two four-character literals: Good or Fail. You can use the standard property @baseclass.pyStatusValue.
Status message propertyOptional. Enter the name of a Single Value property that the system uses to provide additional information about an error that occurred when processing the remote service request. You can use the standard property @baseclass.pyStatusMessage.
Error handler flowOptional. Identify a flow rule that is to be started when this connector rule is started by a flow rule but fails. The default flow rule Work-.ConnectionProblem provides one approach for handling such problems. See Handling connector exceptions.
Test connectivityOptional. Click Test connectivity at any time after you have completed the information on this tab and saved the rule form.

Pega Platform attempts to connect to the MQ server identified, the queue manager, the request queue, and the response queue. The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step. It does not call the service.

SimulationsClick to create a simulator for this connect rule. See Creating connect simulators.
  • Previous topic Connect MQ Rules - Completing the Create, Save As, or Specialization form
  • Next topic Connect MQ form - Completing the Request tab

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.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us