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.
Therefore, 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.
Before you run the migration utility, you must create
the target CICS VR V5R1 RCDSs.
After 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.
CICSVR 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.
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:
//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)
//*
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.
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. 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.