structure, format of trace-route reply message" /> Trace-route reply message format

 

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. For information on trace-route messaging, see Trace-route messaging.

Trace-route reply messages contain the following:

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, see Controlling queue managers for trace-route messaging.

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

Table 19. Trace-route reply message format
Message descriptor
Message data
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
 
Notes:

  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.