Migration from an earlier CICS® VR release

CICS® VR is fully downwards compatible with CICS® VR 6.1, 5.2, 5.1, 4.3 and 4.2. If you are migrating from CICS® VR V4R2, V4R3, V5R1, V5R2 or V6R1 you do not need to migrate the contents of your existing CICS® VR RCDSs.

The RCDS format in CICS® VR V5R2 is unchanged from CICS® VR V5R1, V4R2 or V4R3.

CICS® VR provides a migration utility, DWWMIW, to assist with RCDS migration. If you need to run this utility, first create the target CICS® VR V6R3 RCDSs.

CICS® VR V6R3 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.

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

Figure 1. Sample JCL to run the CICS® VR V6R3 migration utility

//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 6.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)
//DWWIN    DD  *                                               (10)
     MIGRATE RCDS DEFAULTS (YES)
//*

(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 V6R3 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 V6R3 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 to be migrated.

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

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

The jobs allocate the CICS® VR V6R3 libraries and update STEPLIB if required.
The jobs allocate the CICS® VR V6R3 RCDSs and update DWWCON1, DWWCON2, and DWWCON3 if required.

All data sets that were created for use with the panel interface of a previous CICS® VR release work with the CICS® VR V6R3 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.