+

Search Tips | Advanced Search

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.