Troubleshooting for IBM MQ .NET Clients

Splunk AppDynamics Monitor Agent tool adds an additional RFH header to the MQ message before adding the message to the queue. Because of this additional RFH header, IBM MQ .NET Clients may report an MQRC_HEADER_ERROR (MQRC 2142) while parsing the message. Following is the sample RFH header that gets added to MQMessage.

RFH ….x…”…3…MQSTR ……..P…<usr><singularityheaderdt=”string” >notxdetect=True</singularityheader></usr>

The RFH2 structure begins with <usr><singularityheader dt=”string” >. This RFH header is added by the Splunk AppDynamics Monitor Agent tool and not by MQ.

Perform these steps to disable the additional header on the tool:

  1. Go to Configuration > Instrumentation> > Backend Detection.
  2. Click on your application name, go to the .NET tab and click Queues.
  3. Click Edit Automatic Discovery and in the popup, clear the Correlation Enabled checkbox.