Trace-route reply message format

Trace-route reply messages are standard IBM MQ messages containing a message descriptor and message data. The message data contains information about the activities performed on a trace-route message as it has been routed through a queue manager network.

Trace-route reply messages contain the following information:

A message descriptor

An MQMD structure

Message data

A PCF header (MQCFH) and trace-route reply message data

Trace-route reply message data consists of one or more Activity PCF groups.

When a trace-route message reaches its target queue, a trace-route reply message can be generated that contains a copy of the activity information from the trace-route message. The trace-route reply message will be delivered to a reply-to queue or to a system queue.

Table 1 shows the structure of a trace-route reply message, including parameters that are only returned under certain conditions.

MQMD structure	PCF header MQCFH structure	Trace-route reply message data
Structure identifier Structure version Report options Message type Expiration time Feedback Encoding Coded character set ID Message format Priority Persistence Message identifier Correlation identifier Backout count Reply-to queue Reply-to queue manager User identifier Accounting token Application identity data Application type Application name Put date Put time Application origin data Group identifier Message sequence number Offset Message flags Original length	PCF header (MQCFH) Structure type Structure length Structure version Command identifier Message sequence number Control options Completion code Reason code Parameter count	Activity Activity application name Activity application type Activity description Operation Operation type Operation date Operation time Message Message length MQMD EmbeddedMQMD Queue manager name Queue sharing group name Queue name 1 2 3 Resolved queue name 1 3 Remote queue name 3 Remote queue manager- name 2 3 4 5 Feedback 2 Channel name 4 5 Channel type 4 5 Transmission queue name 5 TraceRoute Detail Recorded activities Unrecorded activities Discontinuity count Max activities Accumulate Deliver
Note: Returned for Get and Browse operations. Returned for Discard operations. Returned for Put, Put Reply, and Put Report operations. Returned for Receive operations. Returned for Send operations.

Parent topic: Trace-route reply message reference