How to set custom headers in JMS MQ Messages?

Document ID : KB000015976
Last Modified Date : 14/02/2018
Show Technical Document Details

This article will provide information on adding custom headers in JMS Send Receive step.


How to send custom headers in JMS MQ Messages?

DevTest versions, which support new "JMS Send Receive" step.

First, need to add the IBM MQ jars to DevTest_Home/lib/shared folder. Please refer the documentation at

We are adding custom headers to MQ messages which are using JMS Mode, so need to have javax.jms-api-2.0.jar to the DevTest_Home/lib/shared folder also. The javax.jms-api-2.0.jar can be downloaded from

After adding the MQ jars, start the Workstation and configure JMS assets in project.config and verify it. 

Once the JMS configuration is verified, create a test case and add a "JMS Send Receive" step and configure the custom properties as below:

. Click on the "PRO" icon in the top right corner of the "JMS Send Receive" step.


. In the JMS Send section click on the Custom Properties-->Open Editor, which opens custom properties window.


. Click on the "+" and select the type of the custom property to be added and then add it and click "OK".


. Add the message data in the "Content" section and save the test.


. Click the green arrow "->" on the top right corner and verify the Request-->headers. Headers should show what is added in the Custom properties. 


Additional Information:

Need the below jars for MQ:







. connector.jar

. dhbcore.jar

. javax.jms-api-2.0.jar (if you are using WebSphere MQ in JMS mode)