Enabling applications for trace-route messaging

Message channel agents (MCAs) are enabled for trace-route messaging. The algorithm that MCAs use is detailed below. To enable a user application for trace-route messaging, use this algorithm with the exception of steps 2 and 6.

Note:
Enabling a user application for trace-route messaging can be complicated, only enable user applications where necessary.

  1. Determine whether the message being processed is a trace-route message.

    Compare the format of the message with the format of a trace-route message as detailed in Trace-route message reference.

  2. If the trace-route message is received from a queue manager prior to WebSphere MQ Version 6.0, increment the parameter, DiscontinuityCount, in the trace-route message data.
    Note:
    User applications do not perform this step.
  3. Determine whether activity information is to be recorded.

    Providing the detail level of the performed activity is not less than the level of detail specified by the parameter Detail, activity information will be recorded if the trace-route message requests accumulation and the queue manager is enabled for trace-route messaging, or if the trace-route message requests an activity report and the queue manager is enabled for activity recording.

  4. Determine whether the total number of activities performed on the trace-route message exceeds the value of the parameter MaxActivities.

    The total number of activities is the sum of RecordedActivities, UnrecordedActivities, and DiscontinuityCount.

  5. If both of the following conditions are true: then write an Activity PCF group to the end of the PCF block in the message data of a trace-route message.

    The format of the Activity PCF group is detailed in Activity report message data.

  6. If delivering the trace-route message to a transmission queue, then follow the algorithm specified in Forwarding.
    Note:
    User applications do not perform this step.
  7. If delivering the trace-route message to a local queue, then do one of the following:
  8. If all the following conditions are true: then generate a trace-route reply message.

    The format of the trace-route reply message is detailed in Trace-route reply message reference. The trace-route reply message is put on the queue determined by the queue manager attribute, ROUTEREC. For information on this queue manager attribute, see Controlling queue managers for trace-route messaging.

  9. If the trace-route message requested an activity report and the queue manager is enabled for activity recording, then generate an activity report.

    The format of the activity report is detailed in Activity report reference. The activity report is put on the queue determined by the queue manager attribute, ACTIVREC. For information on this queue manager attribute, see Controlling queue managers for activity recording.