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.
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.
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.
The following sample JCL to run the CICS VR migration utility contains an example
of running the DWWMIW program to migrate RCDSs:
//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)
//*
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
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).
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.