Control the trace within IBM MQ for z/OS

IBM MQ for z/OS trace is controlled using MQSC commands. Use this topic to understand how to control the trace, and the type of trace information that is output.

Use the START TRACE command, specifying type GLOBAL to start writing IBM MQ records to the GTF. We must also specify dest(GTF), for example in the following command: 
/cpf start trace(G)class(2,3)dest(GTF)
To define the events that we want to produce trace data for, use one or more of the following classes:

CLASS Event traced
2 Record the MQI call and MQI parameters when a completion code other than MQRC_NONE is detected.
3 Record the MQI call and MQI parameters on entry to and exit from the queue manager.
After the trace has started, we can display information about, alter the properties of, and stop, the trace with the following commands:

  • DISPLAY TRACE
  • ALTER TRACE
  • STOP TRACE

To use any of the trace commands, we must have one of the following:

  • Authority to issue start and stop trace commands (trace authority)
  • Authority to issue the display trace command (display authority)

Note:

  1. The trace commands can also be entered through the initialization input data sets.
  2. The trace information produced will also include details of syncpoint flows - for example PREPARE and COMMIT.

For information about these commands, see MQSC commands.

Parent topic: The MQI call and user parameter, and GTF on z/OS