IBM Support

DWW1817S for DWWCOPY1 with RC12 when running DWWJUP utility PRINT COPY

Question & Answer


Question

What do I need to do to print my logstream copy? My job is failing with a return code 12 and message DWW1817S for ddname DWWCOPY1 when running the CICS VSAM Recovery for z/OS (CICS VR) DWWJUP utility to print a copy of a forward recovery logstream produced earlier using the DWWLC utility.

I am referring to the CICS VR documentation in topic PRINT: print information about records logged on an MVS log and using the following example JCL from Figure 2. Print a QSAM copy of the MVS log:

 //*-------------------------------------------------------*/
 //* Print the copy of the mvslog                          */
 //*-------------------------------------------------------*/
 //PRIINT   JOB ,CICSVR,MSGCLASS=H,CLASS=A,MSGLEVEL=(1,1),
 //             REGION=4096K,NOTIFY=USERID
 //PRINTLOG EXEC PGM=DWWJUP
 //STEPLIB  DD DSN=DWW.SDWWLOAD,DISP=SHR   /* CICSVR LOADLIB */
 // DD DSN=DWW.SDWWLENU,DISP=SHR
 //DWWPRINT DD SYSOUT=*
 //DWWMSG   DD SYSOUT=*
 //DWWLOG   DD DSN=DWW.LOGCOPY,DISP=SHR      /* COPY OF THE MVSLOG */
 //DWWIN    DD *
    PRINT CICSVR COPY
 //*

My DWWMSG SYSOUT DD shows the following...

 CICSVR - CICS VSAM RECOVERY                                           DATE : 16/11/08     TIME : 21:40:54     PAGE : 1 
                                                                                                                        
 DWW1811I The Journal Print utility is started at 2016/11/08 21:40:54.                                                  
 PRINT ALL COPY                                                                                           
 DWW1813I Command processing is complete. The maximum condition code is 0.                                                                                                                      
 DWW1817S The ddname DWWCOPY1, which is required for this utility, is not present in the JCL.                                                                                                                     
 DWW1812I The Journal Print utility is terminated. The maximum condition code is 12.

I added a DWWCOPY1 DD statement to allocate a new output data set, but now when the job completes, the DWWCOPY1 data set is empty.

Answer

I get the same results when I use the example JCL in Figure 2. of topic PRINT: print information about records logged on an MVS log

I checked the code in DWWJUCIV. If the COPY keyword is specified the code sets juin_copy = ON. In DWWJUTOP if juin_copy is ON, DWWCOPY1 is opened for input to read the QSAM copy. The DWWCOPY1 DD is not included in the CiCS VR documentation for the DWWJUP utility, but the example implies the DWWLOG DD can be used.

I wrote some records to a data set with a forward recovery logstream and ran DWWLC to do a LOGSTREAMCOPY to a QSAM data set and then ran DWWJUP with the following JCL to print the copy.

 //DWWJUP1  JOB (3871),'BULFIN',CLASS=A,REGION=32M,MSGCLASS=R,
 // NOTIFY=&SYSUID
 /*JOBPARM SYSAFF=MV20
 //PRINTLOG EXEC PGM=DWWJUP
 //STEPLIB DD DSN=PTFB.CVR520.SDWWLOAD,DISP=SHR
 //        DD DSN=PTFB.CVR520.SDWWLENU,DISP=SHR
 //DWWPRINT DD SYSOUT=*
 //DWWMSG DD SYSOUT=*
 //DWWCOPY1  DD DISP=SHR,
 //          DSN=BULFIN.CICSVR52.DWWCOPY1
 //DWWIN DD *
 PRINT ALL COPY
 //*

The DWWPRINT DD for SYSOUT contained the contents of the QSAM copy.

A request has been submitted to CICS VR development to update the example in Figure 2. Print a QSAM copy of the MVS log in the documentation as follows:

  • remove the DWWLOG DD

  • add the DWWCOPY1 DD

and to update the description of the COPY keyword with this requirement.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSQJMU","label":"CICS VSAM Recovery for z\/OS"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICSVR CICS VR

Document Information

Modified date:
10 November 2016

UID

dwa1319231