Formatting and identifying the control block information on z/OS

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

• Formatting the information
• Identifying the control blocks associated with IBM MQ
• Identifying the event identifier associated with the control block

Formatting the information

To format the user parameter data that is collected by the global trace, use either the batch job that is 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.

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

//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 start of each control block. These messages 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

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

Related concepts

• Control the GTF on z/OS