Migration from an earlier CICS VR release

CICS® VR V2R2 or higher stores all recovery information in the CICS VR recovery control data sets (RCDSs). However, the format of the RCDSs changed in CICS VR V4R2 from all previous RCDS formats. They have not changed again in CICS VR V4R3.

Start of changeTherefore, to transfer the CICS VR recovery information to CICS VR V4R3 from versions earlier than CICS VR V4R2, you migrate the contents of your existing CICS VR RCDSs into the CICS VR V4R3 format which is the same as the CICS VR V4R2 format. CICS VR V4R3 provides a migration utility, DWWMIW, to assist with RCDS migration from CICS VR V4R1 or earlier. You must not use the CICS VR V4R3 migration utility with RCDSs that were used with CICS VR V4R2End of change

Before you run the migration utility, you must create the target CICS VR V4R3 RCDSs. Note that the RCDS naming convention when using the CICS VR server address space has changed compared with CICS VR V3R2 or earlier. See Activating the CICS VR server address space for information about creating CICS VR V4R3 RCDSs, and other required data sets.

After creating the target CICS VR V4R3 RCDSs, migrate the CICS VR RCDSs by running the CICS VR DWWMIW program. You can use the CICS VR V4R3 migration utility with RCDSs that were used with CICS VR V2R2, V2R3, V3R1, V3R2, V3R3, V4R1 without APAR PK28852, or V4R1 with APAR PK28852.

Start of changeYou must not use the CICS VR V4R3 migration utility with RCDSs that were used with CICS VR V4R2. End of change

Start of changeCICS VR releases earlier than V2R2 do not store recovery information in recovery control data sets. Therefore, when migrating to CICS VR V4R3 from a CICS VR release earlier than V2R2, you do not run the CICS VR migration utility.End of change

Start of changeSample 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 V4R3 format:End of change

Start of change
Figure 1. Sample JCL to run the CICS VR V4R3 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 V4R3 FORMAT.
//*
//STEP1 EXEC PGM=DWWMIW                                         1 
//STEPLIB DD DISP=SHR,DSN=DWW.SDWWLOAD ! CICSVR 4.3 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 
//*
End of change
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 V4R3 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 V4R3 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.

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

Start of changeAll data sets that were created for use with the panel interface of a previous CICS VR release work with the CICS VR V4R3 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.End of change

Note: Start of change

CICS VR V4.3 migration utility does not migrate CICS VR_General_Control parameters CBAUTO, DSSLDREG, LCDEL, LOLSCAN, REALDDN and SECURITY from CICS VR V4.1 . See Defining a CICS VR general control parameter to setup these parameters for CICS VR V4.3 server address space. You can check acting default values with the SETSMS CICSVR_GENERAL_CONTROL(DISPLAY DEFAULTS) command.

In CICS VR V4.3 you can also use the ISPF dialog interface to check CICS VR Server address space defaults and update them. Select 8 (CICS VR server default settings) from the CICS VR main menu panel and then 3 (Server default settings).

In CICS VR V4.3 you can use the new SETUP parameter in the new IGDSMSxx SYS1.PARMLIB member to specify a setup job that must be run during the initialization of the CICS VR server address space to set Server address space defaults. For example:
CICSVR_GENERAL_CONTROL(SETUP DWWRMDFS)
CICS VR supplies a sample job DWWRMDFS to show how to activate several defaults.
End of change