Adding message headers

You add a header to IBM® MQ messages by setting values in the configuration tabs. To publish a simple message and wait for a response to be received, only a few of the options under the General tab need to be set.

About this task

An RFH2 content block cannot be used after an RFH1 content block in HCL OneTest API messages. The jms, mcd, and usr child elements can be added to RFH2 blocks.

Important: You can also configure the MQMD (Message Queue Message Descriptor) by using the additional tabs, including details such as the message and correlation IDs, reporting, segmentation, and context details. The IBM® online WebSphere® MQ product documentation provides a list of the attributes for each of these tabs. For more information, see Message Properties.

Procedure

  1. Enter the name of a local IBM® MQ queue that can be found on the queue manager. Select Browse to browse a list of available queues in the Queue Name Selector. Type the first few characters of the queue name in the text box to filter the list of queue names.
  2. In the Message Type list, click Request.
  3. In the Reply Queue list, click the reply queue.
  4. Optional: Configure the MQMD (Message Queue Message Descriptor) by using the additional header tabs on the Config page. You can change the message and correlation IDs, and reporting, segmentation, and context details.
  5. To add a header to a message, right-click MQ Message (Message) > Add Child. Select a header from the list.

    Adding message headers to Send Request action

  6. Optional: You can set other header fields in the message header itself.
    For example, to specify a different user name, click the Value tab and locate the userId field in the GrpIdentContext group. Double-click the field to enter a new value by using the Field Editor.
  7. When you finish adding the message header, click OK to save the settings and close the dialog.
  8. Double-click the Receive Reply action to open it for editing.
  9. If necessary, click the Config tab.

    The Reply to field and Formatter default to values from the Send Request action.

    Default values for Receive Reply action

  10. To add a header to a message, right-click MQ Message (Message) > Add Child. Select a header from the list.

    Adding a message header to a Receive Reply action