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.