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:

Parent topic: Trace-route message reference