+

Search Tips | Advanced Search

Recording additional activity information: Example 1

Additional activity information is recorded by a user application in a format where the parameter identifier is not 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. The necessary options are set to request the following:

    • Activity information is accumulated in the message data of the trace-route message.
    • On arrival at the target queue the trace-route message is discarded, and a trace-route reply message is generated and delivered to a specified reply-to queue.
    • On receipt of the trace-route reply message, the IBM MQ display route application displays the accumulated activity information.
    The trace-route message is put into the queue manager network.
  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 parameter to the end of the Activity group:

      ColorValue

        Identifier
        65536

        Data type
        MQCFST

        Value
        'Red'

    This additional PCF parameter gives further information about the activity that was performed, however it is written in a format where the parameter identifier is not 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: 
    65536: 'Red'
    The IBM MQ display route application does not recognize the parameter identifier of the PCF parameter and displays it as a numeric value. The context of the additional information is not clear.

    For an example of when the IBM MQ display route application does recognize the parameter identifier of the PCF parameter, see Recording additional activity information: Example 2.