![[z/OS]](ngzos.gif)
Controlling 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. You 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 you want to produce trace data for, use one or more of the following
classes:
After the trace has started, you can display information about, alter the properties of,
and stop, the trace with the following commands:
| 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. |
- DISPLAY TRACE
- ALTER TRACE
- STOP TRACE
To use any of the trace commands, you 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:
- The trace commands can also be entered through the initialization input data sets.
- The trace information produced will also include details of syncpoint flows - for example PREPARE and COMMIT.
For information about these commands, see MQSC commands.