Using DFSMSdss COPY

You can use the DFSMSdss COPY command to make copies of VSAM data sets for use by CICS® VR.

This data set copy 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.