Trace-route message data
The content of trace-route message data depends on the Accumulate parameter
from the TraceRoute PCF group, see Trace-route message data format. Trace-route
message data consists of the TraceRoute PCF group, and zero or more Activity PCF groups. The TraceRoute PCF group is detailed below.
For details of the Activity PCF group, see Activity report message data and Operation-specific activity report message data.
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.
|
Datatype:
| 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.
|
Datatype:
| 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.
|
Datatype:
| 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.
|
Datatype:
| 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.
|
Datatype:
| 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.
|
Datatype:
| 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.
|
Datatype:
| 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. Queue managers use an algorithm when determining whether
to forward a message to a remote queue manager. For details of this algorithm,
see Forwarding.
|
Identifier:
| MQIACF_ROUTE_FORWARDING.
|
Datatype:
| 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.
|
Datatype:
| 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.
|
For details of the Activity PCF group, see Activity report message data and Operation-specific activity report message data.