MQ Tracing - Header Insertion results in Message Queue problems.

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


 After configuring the APM MQ Agent to perform MQ tracing, and restarting my application, the message queue begins to behave abnormally. What can be done to fix this?


Introscope MQ Agent from 9.5x to 10x

  This can occur due to insertion of correlation id’s in MQ headers. Applications with strict MQ message validation may reject MQ messages with altered headers.


 This can be addressed by disabling MQ header insertion. By default, the MQ header insertion property is enabled in MQPP. It will enable the MQ header insertion for MQRFH2 and JMS headers. It is needed to correlate MQ connector calls with other Java components. If it is disabled, then the correlation between the traces might not happen properly. To disable the MQ header insertion, make the following change in the file.


mq.headerinsertion.enabled= false


mq.headerread.enabled= false


After making these changes, the MQ Agent will need to be restarted.




Additional Information: