Skip to main content


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

Connect MQ form - Completing the Response tab

Updated on April 6, 2022

Complete the optional Response tab to specify the data read at runtime from the incoming response message. Define how Pega Platform maps the data from fields in the message header or parameter values in the message body to the clipboard.

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.

When using a dynamic queue, this tab is required.

Response headers

FieldDescription
Field Select a MQ message header field from the selection list:
  • Char Set — Character set identifier of message data.
  • Correl ID — Correlation ID
  • Encoding — Numeric encoding of message data
  • Expiry — The period of time, measured in milliseconds, during which a message is eligible to be successfully retrieved before it is discarded
  • Feedback
  • Format — Eight-byte format
  • Msg ID
  • Msg Type — Message type
  • Persistence — Message persistence
  • Priority — Message priority
  • User ID — User identifier
DescriptionEnter a text description.
Map to Select Clipboard to indicate that the system maps the data value from the scalar property specified in the Map to key to the clipboard.
Map to keyEnter the property name to which the data is mapped.

Response data

If the response is a Datagram (Msg Type is 8), no response data is received. Leave this array blank.

FieldDescription
Data type Select the external data type of the response parameter: String, Integer, Bytes, All Chars, All Bytes, Double, or Boolean.

To read the entire message buffer as one variable-length text or binary data, specify All Chars or All Bytes in the first row of this array, and leave the Length field blank. Leave other rows blank. In this case, the system does not read the length from the message buffer.

Note: As a best practice, use All Chars or All Bytes. Do not use String because it prepends an integer of the length of the string to the data.
OffsetOptional. Enter a number of bytes. At runtime, the system advances the cursor within the message buffer to this index position before it reads the data.
Length Optional. Used only for text ( String ) and binary (Bytes ) data types. Enter a fixed length for the data being read.
  • If the data type is String, this is the character-length of the text value.
  • If the data type is Bytes, this is the length of the byte-array.

If you do not specify a data length for a text or binary value, the system reads an integer representing the true string length from the data buffer immediately before it reads the value.

DescriptionEnter a text description of this data mapping.
Map to Select how the system processes response values. The choice you make for this field depends on what you select for data type :
  • Clipboard — The system maps the data value to the property specified by the Map to key .
  • XML ParseRule — Indicates that the incoming data value from the sending application is an XML document to be parsed using the data mappings specified in a Parse XML rule.
  • HTML PostData — Indicates that the incoming data value from the sending application is a stream of data posted from an HTML form that contains property key/value pairs.

If more choices appear, they each identify a custom function rule in a MapTo library. Review the function rule to determine what it does.

Map to keyIdentify a destination for the Map to operation:
  • If you map to Clipboard, enter the property to which data is mapped.
  • If you map to XML ParseRule, enter the Namespace name (second key part) and the Element Name name — third key part — of the appropriate Parse XML rule. Separate the Namespace from the Element Name with a space. That is, use the syntax "NamespaceName ElementName". The system uses the Applies to class of this connector rule as the first key part of the parse rule.
  • Note: To maintain backward compatibility for connector rules created in releases before PRPC Version 5.2, you can specify a data mapping with only a Namespace value. In that case, the system at run time determines the Element Name key from the root element of the incoming XML document. However, this mapping works only if the Parser Type of the Parse XML rule is set to DOM and validation is not enabled. As a best practice, specify both the Namespace Name and the Element Name of the rule.
  • If you map to HTML PostData, leave this field blank. The name/value pairs in the string will be mapped to the parameter page of the service activity rather than the primary page.
  • If you map to a Rule-Utility-Function from a MapTo library, either select a property to hold the results of the function or leave this field blank, as appropriate for the function.

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