Trace-route message data
Use this page to view the parameters that make up the TraceRoute PCF group part of trace-route message data
The content of trace-route message data depends on the Accumulate parameter from the TraceRoute PCF group. Trace-route message data consists of the TraceRoute PCF group, and zero or more Activity PCF groups. The TraceRoute PCF group is detailed in this topic. Refer to the related information for details of the Activity PCF group.
Trace-route message data contains the following parameters:
- TraceRoute
-
Description: Grouped parameters specifying attributes of the trace-route message. For a trace-route message, some of these parameters can be altered to control how it is processed. Identifier: MQGACF_TRACE_ROUTE. Data type: MQCFGR. Contained in PCF group: None. Parameters in group: - Detail
- RecordedActivities
- UnrecordedActivities
- DiscontinuityCount
- MaxActivities
- Accumulate
- Forward
- Deliver
- Detail
-
Description: The detail level that will be recorded for the activity. Identifier: MQIACF_ROUTE_DETAIL. Data type: MQCFIN. Contained in PCF group: TraceRoute. Values: - MQROUTE_DETAIL_LOW
- Activities performed by user-written application are recorded.
- MQROUTE_DETAIL_MEDIUM
- Activities specified in MQROUTE_DETAIL_LOW are recorded. Additionally, activities performed by MCAs are recorded.
- MQROUTE_DETAIL_HIGH
- Activities specified in MQROUTE_DETAIL_LOW, and MQROUTE_DETAIL_MEDIUM are recorded. MCAs do not record any further activity information at this level of detail. This option is only available to user-written applications that are to record further activity information.
- RecordedActivities
-
Description: The number of activities that the trace-route message has caused, where information was recorded. Identifier: MQIACF_RECORDED_ACTIVITIES. Data type: MQCFIN. Contained in PCF group: TraceRoute. - UnrecordedActivities
-
Description: The number of activities that the trace-route message has caused, where information was not recorded. Identifier: MQIACF_UNRECORDED_ACTIVITIES. Data type: MQCFIN. Contained in PCF group: TraceRoute. - DiscontinuityCount
-
Description: The number of times a trace-route message has been received from a queue manager that does not support trace-route messaging. Identifier: MQIACF_DISCONTINUITY_COUNT. Data type: MQCFIN. Contained in PCF group: TraceRoute. - MaxActivities
-
Description: The maximum number of activities the trace-route message can be involved in before it stops being processed. Identifier: MQIACF_MAX_ACTIVITIES. Data type: MQCFIN. Contained in PCF group: TraceRoute. Value: - A positive integer
- The maximum number of activities.
- MQROUTE_UNLIMITED_ACTIVITIES
- An unlimited number of activities.
- Accumulate
-
Description: Specifies whether activity information is accumulated within the trace-route message, and whether a reply message containing the accumulated activity information is generated before the trace-route message is discarded or is put on a non-transmission queue. Identifier: MQIACF_ROUTE_ACCUMULATION. Data type: MQCFIN. Contained in PCF group: TraceRoute. Value: - MQROUTE_ACCUMULATE_NONE
- Activity information is not accumulated in the message data of the trace-route message.
- MQROUTE_ACCUMULATE_IN_MSG
- Activity information is accumulated in the message data of the trace-route message.
- MQROUTE_ACCUMULATE_AND_REPLY
- Activity information is accumulated in the message data of the trace-route message, and a trace-route reply message will be generated.
- Forward
-
Description: Specifies queue managers that the trace-route message can be forwarded to. When determining whether to forward a message to a remote queue manager, queue managers use the algorithm that is described in Forwarding. Identifier: MQIACF_ROUTE_FORWARDING. Data type: MQCFIN. Contained in PCF group: TraceRoute. Value: - MQROUTE_FORWARD_IF_SUPPORTED
- The trace-route message is only forwarded to queue managers that will honor the value of the Deliver parameter from the TraceRoute group.
- MQROUTE_FORWARD_ALL
- The trace-route message is forwarded to any queue manager, regardless of whether the value of the Deliver parameter will be honored.
- Deliver
-
Description: Specifies the action to be taken if the trace-route message arrives at the destination queue successfully. Identifier: MQIACF_ROUTE_DELIVERY. Data type: MQCFIN. Contained in PCF group: TraceRoute. Value: - MQROUTE_DELIVER_YES
- On arrival, the trace-route message is put on the target queue. Any application performing a destructive get on the target queue can receive the trace-route message.
- MQROUTE_DELIVER_NO
- On arrival, the trace-route message is discarded.
Parent topic: Trace-route message reference