Migration from an earlier CICS VR release

Start of change CICS® VR stores all recovery information in the CICS VR recovery control data sets (RCDSs). The RCDS format in CICS VR V5R1 with APAR PM89649 applied is the same as the RCDS format in CICS VR V4R2 or V4R3, so migration of these data sets is not required. However, if you have CICS VR V5R1 without APAR PM89649 applied and have already migrated the RCDSs, additional migration is required. End of change

Start of change If you are migrating from CICS VR V4R2 or V4R3 to CICS VR V5R1 with APAR PM89649 applied, you do not need to migrate the contents of your existing CICS VR RCDSs. End of change

Start of change If you have already migrated from CICS VR V4R2 or V4R3 to CICS VR V5R1 without APAR PM89649 and have already run the DWWMIW utility to migrate the contents of your existing CICS VR RCDSs, use the following procedure:
  1. Apply APAR PM89649.
  2. Create the target CICS VR V5R1 RCDSs.
  3. Run the CICS VR DWWMIW migration utility again.
End of change

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

Start of change The following sample JCL to run the CICS VR migration utility contains an example of running the DWWMIW program to migrate RCDSs: End of change

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
//*
//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.

Start of change  7 - 9  Specifies the RCDSs to be migrated. End of change

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. 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.


Information Information

Feedback


Timestamp icon Last updated: Friday, 29 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwig/dwwig00051.html