Recording additional activity information: Example 2

Additional activity information is recorded by a user application in a format where the parameter identifier is recognized by the IBM MQ display route application.

1. The IBM MQ display route application is used to generate and put a trace-route message into a queue manager network in the same fashion as in Recording additional activity information: Example 1.
2. As the trace-route message is routed through the queue manager network a user application, that is enabled for trace-route messaging, performs a low detail activity on behalf of the message. In addition to writing the standard activity information to the trace-route message, the user application writes the following PCF parameters to the end of the Activity group:

   ColorInfo

   Description	Grouped parameters specifying information about a color.
   Identifier:	MQGACF_VALUE_NAMING.
   Data type:	MQCFGR.
   Parameters in group:	ColorName ColorValue

   ColorName

   Description	Contains the name to be displayed by the IBM MQ display route application which puts the value of ColorValue into context.
   Identifier:	MQCA_VALUE_NAME.
   Data type:	MQCFST.
   Included in PCF group:	ColorInfo.
   Value:	'Color'

   ColorValue

   Description	Contains the value to be displayed by the IBM MQ display route application.
   Identifier:	65536.
   Data type:	MQCFST.
   Included in PCF group:	ColorInfo.
   Value:	'Red'

   These additional PCF parameters gives further information about the activity that was performed. These PCF parameters are written in a format where the parameter identifier is recognized by the IBM MQ display route application.

3. The trace-route messages reaches the target queue and a trace-route reply message is returned to the IBM MQ display route application. The additional activity information is displayed as follows:

   Color: 'Red'
   

   The IBM MQ display route application recognizes that the parameter identifier of the PCF structure containing the value of the additional activity information has a corresponding name. The corresponding name is displayed instead of the numeric value.

Parent topic: Additional activity information