Access to QMF trace data set DSQDEBUG

If you have a warning or system error during QMF initialization, you must look at the QMF trace data set to understand the reason for the error. In CICS, the trace data set is described as an extra partition data set. The trace data set is described in the CICS tables by a DCT TYPE=SDSCI and a DCT TYPE=EXTRA, as shown in Figure 274.

TITLE 'DSQDCTSD - QMF SDSCI ENTRIES'
* TRACE DATA SET
      DFHDCT TYPE=SDSCI,DSCNAME=DSQDEBUG,
            RECFORM=VARBLK,
            RECSIZE=121,
            BLKSIZE=6050,
            TYPEFILE=OUTPUT
*
      TITLE 'DSQDCT - CICS DESTINATION CONTROL TABLE'
*
* TRACE DATA SET
*
DSQD  DFHDCT TYPE=EXTRA,DESTID=DSQD,DSCNAME=DSQDEBUG,RSL=1

QMF trace data from all the QMF users in a single CICS region is written to a single trace data set. Each trace entry contains the terminal ID of the user that recorded it.

To look at the trace data set while the CICS region is active, you must close the trace data set using the CICS queue ID DSQD. You can do this using the CICS-supplied transaction CEMT. When the trace data set is closed, you can print or browse it from ISPF on TSO. When the trace data set is closed, no other records can be written by CICS users. QMF continues to operate in this state without recording trace records. To make the QMF trace available again, you can use the CICS-supplied transaction CEMT to open the trace data set using the CICS queue ID DSQD.