Using the RCDS utility to import your RCDS

The primary site sends the remote site SAM data sets that contain extracted recovery information from the primary site's RCDS regularly.

These SAM data sets must have been created by the RCDS utility. They contain recovery information required by the CICS® VR panel interface to create a recovery job for the VSAM spheres at the remote site. Start the RCDS utility with the IMPORT keyword specified to put the contents of the latest SAM data set into the remote site's RCDS.

Note:

When using the remote recovery site to recover VSAM spheres, start with an empty RCDS at the remote site and only import the latest RCDS SAM data set.

Use the RCDS command with the IMPORT keyword specified to tell CICS® VR to copy recovery information from the SAM data set that is specified on the DWWCOPY1 DD statement into the RCDS specified in the DWWCON1, DWWCON2, and DWWCON3 DD statements. Recovery information from the SAM data set is merged into the remote site's RCDS.

Below is a sample RCDS IMPORT job that updates the remote site's RCDS with the recovery information from the SAM data set. The SAM data set specified must be a data set that was produced by a previous RCDS EXPORT job.

Figure 1. Sample RCDS IMPORT job to update the remote recovery site's RCDS

//RCDSIM  JOB (ACCT),'USER',CLASS=A,NOTIFY=,MSGLEVEL=(1,1)     01  
//IMPORT   EXEC PGM=DWWGJCDS                                   02  
//STEPLIB  DD   DSN=DWW.SDWWLOAD,DISP=SHR                      03  
// DD DSN=DWW.SDWWLENU,DISP=SHR
//DWWCOPY1 DD   DSN=USER1.DWWCOPYR,                            04  
//              UNIT=3590,VOL=SER=TAPE04                       05  
//DWWCON1  DD   DISP=SHR,DSN=DWW.DWWCON1                       06  
//DWWCON2  DD   DISP=SHR,DSN=DWW.DWWCON2                       07  
//DWWCON3  DD   DISP=SHR,DSN=DWW.DWWCON3                       08  
//DWWMSG   DD   SYSOUT=*                                       09  
//DWWPRINT DD   SYSOUT=*                                       10  
//DWWIN    DD   *                                              11  
           RCDS IMPORT                                         12  
/*                                                                 
//

Here is a description of each of the numbered statements:

Line: Explanation
01: JOB statement defines a CICS® VR job.
02: EXEC statement defines a CICS® VR job step. Specifies that the program DWWGJCDS is to be run. The prefix DWW always refers to a component of CICS® VR.
03: STEPLIB DD statement. Specifies the name of the CICS® VR load library, for example, DWW.SDWWLOAD, used for this job step.
04–05: This is the DWWCOPY1 DD statement. It specifies the SAM data set, USER1.DWWCOPYR, from which the IMPORTed RCDS information is extracted and stored into the RCDS data sets specified on the DWWCON1–DWWCON3 DD statements. USER1.DWWCOPYR is on a standard label 3590 volume TAPE04.
06–08: DWWCON1–DWWCON3 defines the three recovery control data sets. If you are running the CICS® VR server, you must use the hlq.slq that was defined in the IGDSMSxx PARMLIB member for these data sets.
Note:
CICS® VR uses three identical RCDS data sets to provide fault tolerance and improved reliability.
09: DWWMSG defines the output data set that contains the CICS® VR messages. 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 27930.
10: 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 27930.
11: This is the DWWIN DD statement. It specifies the data set that contains 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, as shown.
12: This is the RCDS IMPORT command. It specifies that all the RCDS information is copied from the USER1.DWWCOPYR data set to the RCDS data sets, specified on DWWCON1–DWWCON3 DD statements.