Migration from an earlier CICS VR release

CICS® VR stores all recovery information in the CICS VR recovery control data sets (RCDSs). However, the format of the RCDSs changed in CICS VR V5R1 from all previous RCDS formats.

Start of changeTherefore, to transfer the CICS VR recovery information to CICS VR V5R1 you must migrate the contents of your existing CICS VR RCDSs into the CICS VR V5R1 format. CICS VR V5R1 provides a migration utility, DWWMIW, to assist with RCDS migration.End of change

Start of changeBefore you run the migration utility, you must create the target CICS VR V5R1 RCDSs. End of change

Start of changeAfter creating the target CICS VR V5R1 RCDSs, migrate the CICS VR RCDSs by running the CICS VR DWWMIW program. You can use the CICS VR V5R1 migration utility with RCDSs that were used with CICS VR V4R1 without APAR PK28852, V4R1 with APAR PK28852, V4R2 or V4R3.End of change

Start of changeCICSVR V5R1 implements the MIGRATE RCDS command to migrate CICSVR Server AS defaults from previous releases. See MIGRATE RCDS: Specify migration optionfor a detailed description of the MIGRATE command. End of change

Sample JCL to run the CICS VR migration utility, below, contains an example of running the DWWMIW program to migrate RCDSs used with an earlier CICS VR release into the CICS VR V5R1 format:

Figure 1. Sample JCL to run the CICS VR V5R1 migration utilityStart of change
//MIGRATE JOB (ACCOUNT),MSGLEVEL=(1,1),MSGCLASS=H,REGION=4M
//*
//* INVOKE THE CICSVR MIGRATION UTILITY TO MIGRATE AN
//* RCDS USED WITH A PREVIOUS CICSVR RELEASE INTO V5R1 FORMAT.
//*
//STEP1 EXEC PGM=DWWMIW                                         1 
//STEPLIB DD DISP=SHR,DSN=DWW.SDWWLOAD ! CICSVR 5.1 LIB         2 
//        DD DISP=SHR,DSN=DWW.SDWWLENU
//DWWMSG DD SYSOUT=*                   ! MESSAGE DATA SET       3 
//* 
//DWWCON1 DD DISP=SHR,DSN=hlq.slq.DWWCON1.GRPsuffix ! NEW RCDS  4 
//DWWCON2 DD DISP=SHR,DSN=hlq.slq.DWWCON2.GRPsuffix ! NEW RCDS  5 
//DWWCON3 DD DISP=SHR,DSN=hlq.slq.DWWCON3.GRPsuffix ! NEW RCDS  6 
//* 
//DWWOCON1 DD DISP=SHR,DSN=prefix.DWWCON1 ! OLD RCDS            7 
//DWWOCON2 DD DISP=SHR,DSN=prefix.DWWCON2 ! OLD RCDS            8 
//DWWOCON3 DD DISP=SHR,DSN=prefix.DWWCON3 ! OLD RCDS            9 
//DWWIN    DD  *                                                10 
     MIGRATE RCDS DEFAULTS (YES)
//*
End of change

 1  The migration program is DWWMIW. The prefix DWW always refers to a component of CICS VR.

 2  STEPLIB references the CICS VR load library. Be sure the library referenced is the new CICS VR V5R1 load library.

 3  DWWMSG refers to the output data set to which CICS VR writes messages. This data set 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.

 4 – 6  Specifies the target CICS VR V5R1 RCDSs. These RCDSs must be empty and use the required naming convention if using the CICS VR server address space.

 7 - 9  Specifies the RCDSs that were used with a previous release of CICS VR.

Start of change 10  DWWIN defines 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 MIRGATE RCDS command in-stream as shown. You can also specify dummy or empty input data set for using default value for option DEFAULT(NO). End of change

CICS VR utilities continue to work if the following items are true:

All data sets that were created for use with the panel interface of a previous CICS VR release work with the CICS VR V5R1 panel interface. Note that the data sets allocated to the DWWMSG, DWWDMSG, and DWWDUMP ddnames for the panel interface must be different from the ones used with the CICS VR server address space.