Copying CQS log records for diagnostics

IBM® Software Support sometimes requires a copy of a range of CQS log records for problem determination. You can use the IEBGENER utility program to copy some or all of the CQS log for a structure to a BSAM data set for sending to IBM Software Support.

IEBGENER utility program example

The copy made by the IEBGENER utility is a binary image of the log records. The following JCL is a job that copies CQS log records between 15:10 and 15:30 local time on day 89 of 2001 to a data set named CQS.LOG.COPY: 

                                               
//CQSCPYLG  JOB  MSGLEVEL=1,CLASS=K                      
//*********************************************************************
//*  THIS JOB COPIES A CQS LOG STREAM TO A DATASET (MAX 32K / RECORD) *
//*********************************************************************
//STEP1    EXEC  PGM=IEBGENER
//SYSPRINT DD  SYSOUT=*                                                
//SYSUDUMP DD  SYSOUT=*                                                
//SYSIN    DD  DUMMY                                                   
//SYSUT1   DD  DSN=SYSLOG.MSGQ01.LOG,                                  
//             SUBSYS=(LOGR,IXGSEXIT,                                  
//             'FROM=(2001/089,15:10),TO=(2001/089,15:30),LOCAL'),     
//             DCB=(BLKSIZE=32760)                                     
//SYSUT2   DD  DSN=CQS.LOG.COPY,
//             DISP=(NEW,KEEP,DELETE),                                 
//             VOL=SER=EDSDMP,                                         
//             SPACE=(CYL,(10,10)),                                      
//             UNIT=SYSDA

If you copy CQS log records using the IEBGENER utility, the following guidelines apply:

  • The copied records cannot be used by CQS in any way (such as restart or recovery). They are for diagnostic purposes only.
  • CQS log records that are greater than 32 KB in length are truncated. The SUBSYS exit supports a maximum of a 32 KB record size.