Controlling the GTF
Use this topic to understand how to start and stop the GTF.
Starting the GTF
When you start the GTF, specify the USRP option. You are prompted to enter a list of event identifiers (EIDs). The EIDs used by IBM® MQ are:
- 5E9
- To collect information about control blocks on entry to IBM MQ
- 5EA
- To collect information about control blocks on exit from IBM MQ
Sometimes, if an error occurs that you cannot solve yourself, you might be asked by your IBM support center to supply other, internal, trace information for them to analyze. The additional type of trace is:
- 5EE
- To collect information internal to IBM MQ
You can also use the JOBNAMEP option, specifying the batch, CICS®, IMS, or TSO job name, to limit the trace output to specific jobs. Figure 1 illustrates sample startup for the GTF, specifying the four EIDs, and a jobname. The lines shown in bold type like this are the commands that you enter at the console; the other lines are prompts and responses.
For more information about starting the GTF trace, see the MVS Diagnosis: Tools and Service Aids manual.
When using GTF, specify the primary job name (CHINIT, CICS, or batch) in addition to the queue manager name (xxxxMSTR).
Stopping the GTF
When you stop the GTF, you must specify the additional identifier ( yy ) used at startup. Figure 2 illustrates a sample stop command for the GTF. The commands shown in bold type like this are the commands that you enter at the console.