Starting CICS® VR forward recovery

To start the forward recovery functions, run the required JCL and provide the CICS® VR commands you require as parameters on the DWWIN DD statement.

This sample JCL shows the JCL that is required to manually run CICS® VR commands.

The commands specified to the CICS® VR recovery program vary according to the type of recovery requested, what types of logs you are using, log copies or log streams, and so on. For more information see the command descriptions in the see CICS VR commands CICS® VR Implementation Guide and Reference for a description of the proper commands and keywords that are used to perform the type of recovery you need.

Figure 1. Sample JCL to run CICS® VR forward recovery

//CICSVR   JOB  job statement                        (1)
//COMMAND  EXEC PGM=DWWCO                            (2)
//STEPLIB  DD   DSN=DWW.SDWWLOAD,DISP=SHR            (3)
// DD DSN=DWW.SDWWLENU,DISP=SHR
//DWWLOAD DD DISP=SHR,DSN=DWW.SDWWLOAD               (4)
//        DD DISP=SHR,DSN=DWW.SDWWLENU
//        DD DISP=SHR,DSN=exits load library name
//DWWMSG   DD   SYSOUT=*                             (5)
//DWWPRINT DD   SYSOUT=*                             (6)
//DWWCON1 DD DSN=hlq.slq.DWWCON1.GRPsuffix,DISP=SHR  (7)
//DWWCON2 DD DSN=hlq.slq.DWWCON2.GRPsuffix,DISP=SHR
//DWWCON3 DD DSN=hlq.slq.DWWCON3.GRPsuffix,DISP=SHR
//DWWLOG   DD   DSN=LOG03.COPY1.D01159.T221500,      (8)
//              UNIT=TAPE,VOL=SER=123456,DISP=OLD
//DWWIN    DD   *                                    (9)
        .
        .
  CICSVR commands
        .
        .
/*
//
  1. The JOB statement specifies a minimum region size of 2048KB.
  2. The program to be run is DWWCO. The prefix DWW always refers to CICS® VR.
  3. Supply the name of the CICS® VR load library.
  4. DWWLOAD is optional, and defines the alternative load libraries to STEPLIB and the link list, after the top module from EXEC statement has been loaded. After the top module initialization, all following module loads, supplementary CICS® VR modules, and CICS VR exits are from these alternative load libraries.
  5. DWWMSG defines the output data set that contains the messages produced by CICS® VR. This is usually defined as a SYSOUT data set.

    The DCB parameters for this data set are RECFM=FBA and LRECL=133. The block size can be provided on the DWWMSG DD statement and must be a multiple of 133. The default is 133.

  6. DWWPRINT defines the output data set that contains the reports produced by CICS® VR. This is usually defined as a SYSOUT data set.

    The DCB parameters for this data set are RECFM=FBA and LRECL=133. The block size can be provided on the DWWPRINT DD statement and must be a multiple of 133. The default is 133.

  7. DWWCONx references the CICS® VR RCDS and must be specified if available. CICS® VR recovery can run when the RCDSs are not specified, however CICS® VR might not be able to use change accumulation data sets or recover updates made by batch jobs if the RCDSs are not specified.
  8. DWWLOG can be used to specify the names of log stream copies or change accumulation data sets to be used during forward recovery processing. However, the MVSLOG command with the appropriate keyword must be specifed, in addition to the RECOVER command, to have CICS® VR use the specified log stream copies or change accumulation data sets. For more information, see MVSLOG: Specify an MVS Log StreamMVSLOG: Specify an MVS™ Log Stream in the CICS® VR Implementation Guide and Reference.
  9. DWWIN defines the input data set containing the CICS® VR commands. You can either specify a sequential data set with 80-byte, fixed-length records, or include the CICS® VR commands in-stream.