Trace-route reply message format

Trace-route reply messages are standard WebSphere® 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.
Table 1. Trace-route reply message format
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:
  1. Returned for Get and Browse operations.
  2. Returned for Discard operations.
  3. Returned for Put, Put Reply, and Put Report operations.
  4. Returned for Receive operations.
  5. Returned for Send operations.