LOGCOPY utility (QMR#COPY)

The LOGCOPY utility is used to copy OLDS or SLDS data sets if these data sets need to be sent to BMC Software for message queue error diagnostics.

This utility is used to overwrite the message text portion of the log records on the copied OLDS or SLDS to ensure confidentiality. The report generated by this utility will identify the checkpoint IDs on the input log and provide output log content information.

The following figure shows an example of the LOGCOPY utility JCL. This JCL is in MAQCNTL member QMR#COPY.

//QMRCOPY  JOB ACCT,' QMRCOPY0 '                         <== ADD JOB CARD
//*         $BMCCHG P165215,CNTL CHG DEFAULT TO REQALL 
//*         $BMCCHG P254473,CNTL CORRECT SPELLING ERRORS      @254473 
//*         $BMCCHG P313245,CNTL CORRECT CNTL LIB MEMBERS     @313245 
//*         $BMCCHG F170827,CNTL CHANGE DEFAULT PARMS         #170827 
//* ------------------------------------------------------------------- 
//*       USE THIS JOB TO COPY MESSAGE QUEUE DATA FROM THE OLDS OR SLDS 
//*       TO SEND TO BMC FOR MESSAGE QUEUE ERROR DIAGNOSTICS. 
//*       TO SEND TO BMC FOR MESSAGE QUEUE ERROR DIAGNOSTICS. 
//* 
//*       THE DEFAULT PARM  'REQALL,COPY,CLEAR' IS SUGGESTED. 
//* 
//*   FOLLOWING PARAMETERS CAN BE COMBINED, E.G., PARM='CLEAR,ERE' 
//* 
//*   PARM='REQALL' (DEFAULT) COPIES ALL RECORDS EXCLUDING X'5X' 
//*                 DATABASE UPDATE RECORDS 
//*   PARM='CLEAR'  (DEFAULT) WILL OVERLAY SENSITIVE DATA IN THE 
//*                 MESSAGE TEXT ON X'01', X'03' AND X'4002' LOG RECORDS
//*                 SEE COMMENTS IN PGM SOURCE FOR CLEARING SPA DATA 
//*                 IN X'13' AND X'400E' LOG RECORDS. 
//*   PARM='COPY'   (DEFAULT) WILL SCAN INPUT AND PROVIDE A CHECKPOINT 
//*                 REPORT, OUTPUT IS CREATED. 
//*   PARM='COLD'   COPIES LOG RECORDS USED FOR DUMPQ/PURGE 
//*                 RECOVERY - 4001, 4002, 4003, 4004, 400D, 400E, 
//*                 4021, 4098, 4099. IF DELTA IMS/VT IS PRESENT THE 
//*                 DE40, DE4C AND DE58 RECORDS. 
//*   PARM='ERE'    WILL COPY 01, 03, 3X RECORDS USED IN ERE RECOVERY 
//*                 IN ADDITION TO THE RECORDS FOR 'COLD'. 
//*   PARM='REQIBM' WILL COPY THE LOG RECORDS FOR 'COLD', ERE AND 
//*                 ADDITIONAL 40XX RECORDS USED BY IBM MESSAGE 
//*                 REQUEUER PROGRAMS. 
//*   PARM='NOCOPY' WILL SCAN INPUT AND PROVIDE A CHECKPOINT REPORT, 
//*                 NO OUTPUT IS CREATED. 
//*   PARM='CHKPT=YYDDD/HHMMSST' THE T IS OPTIONAL. 
//*                 THIS CHECKPOINT WILL BE COPIED. CHKPT MUST BE 
//*                 SNAPQ/DUMPQ/PURGE. BY DEFAULT ALL RECORDS WILL 
//*                 BE SELECTED. YOU CAN SPECIFY: COLD, ERE OR 
//*                 REQIBM TO GET SPECIFIC RECORD SETS COPIED 
//* 
//*   THE REPORT WILL IDENTIFY THE CHECKPOINT ID'S ON THE INPUT LOG 
//*   AND PROVIDE OUTPUT LOG CONTENT INFORMATION. 
//* --------------------------------------------------------------------
//QMRCOPY  EXEC   PGM=QMRCOPY0  PARM='REQALL,COPY,CLEAR' IS THE DEFAULT 
//STEPLIB  DD  DSN=MAQLIB,DISP=SHR                               <==MODIFY
//SYSPRINT DD  SYSOUT=*
//IMSLOG   DD DISP=SHR,DSN=IMS.OLDS.OR.SLDS                      <==MODIFY
//QMRCOPY  DD DISP=(NEW,CATLG),DSN=QMRCOPY,UNIT=CART             <==MODIFY

The following table shows the information in the JCL that you might need to add or change for your site.

Item	You should type
Job Card	Job card information valid for your site.
PARM=	A list of optional parameters that you can define. For a description of each parameter, see MAQCNTL member QMR#COPY.
Message Advisor LOAD Library	The location of your Message Advisor LOAD library. The default is MAQLIB.
IMSLOG Data Set	The name of the input OLDS data set.
QMRCOPY Data Set	The name of the output QMRCOPY data set.

Related topic

Using Message Advisor utilities

LOGCOPY utility (QMR#COPY)

Comments