Formatting and identifying the control block information

After capturing a trace, the output must be formatted and the IBM® MQ control blocks identified.

Formatting the information

To format the user parameter data collected by the global trace, use either the batch job shown in Figure 1 or the IPCS GTFTRACE USR( xxx ) command, where xxx is:

5E9: To format information about control blocks on entry to IBM MQ MQI calls
5EA: To format information about control blocks on exit from IBM MQ MQI calls
5EE: To format information about IBM MQ internals

You can also specify the JOBNAME( jobname ) parameter to limit the formatted output to specific jobs.

Figure 1. Formatting the GTF output in batch. thlqual is your high level qualifier for IBM MQ data sets, and gtf.trace is the name of the data set containing your trace information. You must also specify your IPCS data set directory.


//S1 EXEC PGM=IKJEFT01,DYNAMNBR=20,REGION=4096K
//IPCSPARM DD DSN=SYS1.PARMLIB,DISP=SHR
//IPCSDDIR DD DSN=thlqual.ipcs.dataset.directory,DISP=SHR
//SYSTSPRT DD SYSOUT=*,DCB=(LRECL=137)
//IPCSTOC  DD SYSOUT=*
//GTFIN    DD DSN=gtf.trace,DISP=SHR
//SYSTSIN  DD *
IPCS
SETDEF FILE(GTFIN) NOCONFIRM
GTFTRACE USR(5E9,5EA,5EE)
/*
//STEPLIB  DD  DSN=thlqual.SCSQAUTH,DISP=SHR

Identifying the control blocks associated with IBM MQ

The format identifier for the IBM MQ trace is D9. This value appears at the beginning of each formatted control block in the formatted GTF output, in the form:


USRD9

Identifying the event identifier associated with the control block

The trace formatter inserts one of the following messages at the top of each control block. These indicate whether the data was captured on entry to or exit from IBM MQ

CSQW072I ENTRY: MQ user parameter trace
CSQW073I EXIT: MQ user parameter trace