Using DFSMSdss COPY

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:

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.

Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwig/dwwig000170.html