You can use the DFSMSdss COPY command to make copies of VSAM data
sets for use by CICS® VR.
The data set copy below shows how to use the CICSVRBACKUP and
the RENAMEU(**,CICSVR.**) keywords to notify DFSMSdss that the copies are for use
by CICS VR.
Figure 1. DFSMSdss data
set copy for use with CICS VR//JOB6 JOB accounting information,REGION=nnnnK
//STEP1 EXEC PGM=ADRDSSU
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
COPY DATASET( -
INCLUDE(USER1.**)) /* FILTER ON DS W/1ST LEV Q USER1 */ -
OUTDYNAM((339001),(339002),(339003)) /* DYNAM ALLOC VOLS */ -
RENAMEU(**,CICSVR.**) -
CICSVRBACKUP
/*
This example is different than an ordinary DFSMSdss COPY
job. The INCLUDE and the OUTDYNAM keywords operate like the normal DFSMSdss keywords
causing all data sets with the high-level qualifier USER1 that are in the
standard order of search to be copied to the target volumes that are labeled
339001, 339002, and 339003. Since CICSVRBACKUP is specified, RENAMEU(**,CICSVR.**)
does not cause the INCLUDE data sets to be renamed with the CICS VR high
level qualifier. Instead, CICS VR provides DFSMSdss with a unique data set name
for each copy using the naming convention,
prefix.DSOiinnn.Dyyyyddd.Thhmmsst,
where:
- prefix
- Is the CICS VR
data set name, CICSVR_DSNAME_PREFIX, defined in
the IGDSMSxx PARMLIB member.
- DS
- Is the abbreviation for DFSMSdss.
- O
- Is the abbreviation for output.
- ii
- Is the system identifier in the sysplex. It is used to guarantee unique
names across the sysplex.
- nnn
- is a unique request number code (001–999) for each request which arrives
within the same tenth of a second time interval.
- D
- Is the abbreviation for the date.
- yyyy
- Is the year.
- ddd
- Is the day of the year, in Julian format.
- T
- Is the abbreviation for the time.
- hh
- Is the hour of the day, based on a 24-hour clock.
- mm
- Is the number of minutes.
- ss
- Is the number of seconds.
- t
- Is the tenths of a second.
You do not need to remember the names of the backup copies that DFSMSdss creates.
Instead, when you use the CICS VR dialog, you only need to know the name of the
original VSAM sphere and you can select the desired DFSMSdss backup copy from a list of
backups. To view all the backup copies for a VSAM sphere from the CICS VR dialog:
- Select a VSAM sphere that you have created a DFSMSdss copy for from the CICS VR VSAM
sphere list.
- Press F5 for forward recovery only.
- Put the cursor in the backup time field and press F4 to list all the backups
for the selected VSAM sphere.
All the backup copies of the spheres are listed, including the DFSMSdss backups.
Note: The RENAMEU keyword must be specified as "RENAMEU(**,CICSVR.**)" for DFSMSdss to
create backup copies for CICS VR.