Recording additional information
As a trace-route message is routed through a queue manager network, user
applications can record additional information by including one or more additional
PCF parameters when writing the Activity group to the message data
of the trace-route message or activity report. This additional information
can help system administrators to identify the route a trace-route message
took, or why it was taken.
If the WebSphere MQ display route application is used to display the
recorded information for a trace-route message, any additional PCF parameters
can only be displayed with a numeric identifier, unless the parameter identifier
of each parameter is recognized by the WebSphere MQ display route application. To
recognize a parameter identifier, additional information must be recorded
using the following PCF parameters. Include these PCF parameters in an appropriate
place in the Activity PCF group.
- GroupName
-
Description: |
Grouped parameters specifying the additional information. |
Identifier: |
MQGACF_VALUE_NAMING. |
Datatype: |
MQCFGR. |
Parameters in group: |
- ParameterName
- ParameterValue
|
- ParameterName
-
Description: |
Contains the name to be displayed
by the WebSphere MQ display route application, which puts the value of ParameterValue into context. |
Identifier: |
MQCA_VALUE_NAME. |
Datatype: |
MQCFST. |
Included in PCF group: |
GroupName. |
Value: |
The name to be displayed. |
- ParameterValue
-
Description: |
Contains the value to be displayed
by the WebSphere MQ display route application. |
Identifier: |
The PCF structure identifier for the additional information. |
Datatype: |
The PCF structure datatype for the additional information. |
Included in PCF group: |
GroupName. |
Value: |
The value to be displayed. |