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
    Table 1. Color information
    Description Grouped parameters specifying information about a color.
    Identifier: MQGACF_VALUE_NAMING.
    Data type: MQCFGR.
    Parameters in group:
    • ColorName
    • ColorValue
    ColorName
    Table 2. Color name
    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
    Table 3. Color value
    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.