Providing default recovery parameters

Use the "CICS® VR VSAM sphere default parameters" secondary window to apply one set of recovery parameters to all of the selected VSAM spheres during construction of the recovery job.

If you select forward recovery for the selected VSAM spheres, and if Y was entered in the Use default parameters for selected spheres field, the "CICS VR VSAM sphere default parameters" secondary window is displayed:

Figure 1. VSAM sphere default parameters secondary window
                   CICSVR VSAM sphere default parameters                     
                                                                             
 Enter the default values to be used for all selected VSAM spheres.          
                                                                             
   1 - 8 character DSN extension . ________                                         
                                                                             
   Forward-recovery start time . . _______________  (YY.DDD HH:MM:SS)        
                                                                             
   Forward-recovery stop time  . . _______________  (YY.DDD HH:MM:SS)        
                                                                             
   Backup date . . . . . . . . . . ______  (YY.DDD)                          
                                                                             
   Time format  . . . . . Local  +    Backup type  . None____________  +     
                                                                             
   Volume for restore  . . ______     Unit for restore . . . . ________      
                                                                             
                                                                             
                                                                             
 Command ===> ____________________________________________________________   
  F1=Help     F4=Prompt  F12=Cancel                                          
The following list describes the input fields on the VSAM sphere default parameters secondary window. Enter the information in these fields in the same order listed here:
Backup type
To change the backup type selection, place the cursor on the Backup type input field and press F4. The "CICS VR Backup Type Selection" secondary window is displayed allowing you to select a Backup type.
Figure 2. CICS VR Backup Type Selection secondary window
              CICSVR Backup Type Selection                  
                                                              
 Select a backup type to be used during this session and      
 press Enter.                                                 
                                                              
                                                              
 Backup type  1_  1.  None                                    
                  2.  Logical                                 
                  3.  Full Volume Dump                        
                  4.  No tie-ups
                                                   
                                                   
 Command ===> __________________________________   
  F1=Help    F12=Cancel                            

Backup type is a required field; all of the selected VSAM spheres must have the same backup type.

None
Specifies that a backup does not exist for the selected VSAM spheres or you do not want CICS VR to create a recovery job to restore the VSAM spheres from a backup.
Logical
Specifies that a logical backup exists and is known to CICS VR for all selected VSAM spheres. A logical backup is known to CICS VR if it exists in DFSMShsm's inventory or has been registered in the CICS VR RCDS. For all non-DFSMShsm logical backups, you must define a restore skeleton to CICS VR that matches the product identifier of the most recent logical backup that is known to CICS VR for each of the selected spheres. If you specify Logical, CICS VR sets the values for the forward recovery start time and backup date fields to the creation date and time of the most recent logical backup that is known to CICS VR for each sphere. If the most recent logical backup was taken while the data set remained online and open for update, CICS VR sets the forward recovery start time to the recovery point associated with the backup.

See General backup notification,Understanding CICS VR backup support and Restore skeletonsfor further information.

Full volume dump
Specifies that each of the selected VSAM spheres are backed up on the same DFSMShsm full volume dump. Enter the date of the full volume dump in the Backup date field. CICS VR creates a recovery job that restores each VSAM sphere from the specified DFSMShsm full volume dump.
No tie-ups
Specifies that you want CICS VR to restore the VSAM sphere from a backup taken by the hardware, where there is no tie-up record on the log with a time stamp for the start of the backup. Selecting this backup type adds the NOTIEUPS keyword to the generated recovery job.
Time format
To change the time format selection, place the cursor on the Time format input field and press F4. The "CICS VR Time Format Selection" secondary window is displayed and you can select a time format. The CICS VR default value is Local.
Figure 3. CICS VR Time Format selection secondary window
           CICSVR Time Format Selection            
                                                   
 Select a time format to be used during this       
 session and press Enter.                          
                                                   
                                                   
 Time format  1_  1.  Local                        
                  2.  GMT                          
                                                   
                                                   
 Command ===> __________________________________   
  F1=Help    F12=Cancel                            

Time format is a required field and specifies the time format used on the logs of the selected VSAM spheres. All selected VSAM spheres must have the same time format. Changing the time format does not automatically adjust any previously entered dates and times to the newly selected format. After changing the time format, be sure to adjust any entered dates and times on the "CICS VR VSAM sphere default parameters" secondary window accordingly.

The "CICS VR Time Format Selection" secondary window allows you to select from the following time formats:

Local
Specify this option if local time format is used on the logs.
GMT
Specify this option if Greenwich Mean Time (GMT) format is used on the logs.
1 - 8 character DSN extension
The 1–to-8–character DSN extension field is optional. If you enter an extension, it is appended to the name of each selected VSAM sphere. If you do not specify a VSAM sphere name extension, a warning message is displayed. If you do not want to define an extension, press Enter.
Depending on the type of backup you specified, CICS VR creates a recovery job and performs one of the following actions:
  • If you choose Logical or Full Volume Dump as the backup type, CICS VR creates a recovery job that restores and recovers each VSAM sphere to a new VSAM sphere with the modified name. The modified name includes the original sphere name and the appended extension.

    For example, if you enter RECOVERD as the VSAM sphere name extension, select Logical as the backup type, and select VSAM sphere PAYROLL.BASE for a recovery, CICS VR creates a recovery job that restores VSAM sphere PAYROLL.BASE from its most recent logical backup to PAYROLL.BASE.RECOVERD. All after-images are applied to PAYROLL.BASE.RECOVERD. If you do not enter a VSAM sphere name extension, the original VSAM sphere is replaced during the restore and recover.

    For all non-DFSMShsm backups, the restore skeleton associated with the product identifier of the logical backup must contain logic to check for the existence of the CNEWDSN variable and use it if available. The CNEWDSN variable contains the fully qualified sphere name with the appended extension. See the Restore skeletons for more information about restore skeletons.

  • If you choose None as the backup type, CICS VR creates a recovery job that forward recovers each VSAM sphere to a VSAM sphere with the modified name. The modified name includes the original sphere name and the appended extension. This data set must already exist; CICS VR does not create it.

    For example, if you enter RECOVERD as the VSAM sphere name extension, select None as the backup type, and select VSAM sphere PAYROLL.BASE for a recovery, CICS VR creates a recovery job that applies the after-images of VSAM sphere PAYROLL.BASE to VSAM sphere PAYROLL.BASE.RECOVERD. If you do not enter a VSAM sphere name extension, the after-images are applied to the original VSAM sphere.

Forward recovery start time
Forward recovery start time identifies the date and time of the earliest after-images CICS VR uses to recover the selected VSAM spheres. CICS VR creates a recovery job that recovers all updates made on or after this date and time for each selected VSAM sphere. The forward recovery start time requirement is based on your selection of backup type as follows:
  • If you choose Logical as the backup type, leave this field blank. CICS VR uses the creation date and time of the most recent logical backup that is known to CICS VR for each sphere as the forward recovery start time. If the most recent logical backup was taken while the data set remained online and open for update, CICS VR sets the forward recovery start time to the recovery point associated with the backup.
  • If you choose None or Full Volume Dump as the backup type, you must enter a date and time in this field.
Forward recovery stop time
Forward recovery stop time is an optional field. It identifies the date and time of the latest time stamp of the after-images CICS VR uses to recover the selected VSAM spheres. If you leave the field blank, the default value is set to the date and time of when the recovery job is created.
Backup date
Backup date identifies the date of the DFSMShsm full volume dump from which CICS VR restores each selected VSAM sphere. The backup date is based on your selection of backup type as follows:
  • If you choose None as the backup type, leave this field blank.
  • If you choose Logical as the backup type, leave this field blank. CICS VR uses the date and time of the most recent logical backup found for each sphere during the creation of the recovery job.
  • If you choose Full Volume Dump as the backup type, enter the date of the DFSMShsm full volume dump that CICS VR uses to restore the selected VSAM spheres. CICS VR creates a recovery job that restores each selected VSAM sphere from the specified DFSMShsm full volume dump.
Volume for restore
Volume for restore identifies the name of a volume to which you want to restore the VSAM spheres. You can specify a volume only if you choose Logical or Full Volume Dump as the backup type. If you specify a volume, you must enter a value in the Unit for restore field. If the selected VSAM spheres are managed by the storage management subsystem, the volume and unit values are ignored during the run of the recovery job that is created.

For all non-DFSMShsm backups, the restore skeleton that matches the product identifier of the backup checks for the existence of the CNEWVOL variable and uses it if available. The CNEWVOL variable contains the name of the new volume entered through the panel interface.

Unit for restore
Unit for restore identifies the type of unit to which you want to restore the VSAM spheres. You can specify a unit only if you choose Logical or Full Volume Dump as the backup type. If you specify a unit, you must enter a value in the Volume for restore field. If the selected VSAM spheres are managed by the storage management subsystem, the volume and unit values are ignored during the run of the recovery job that is created.

For all non-DFSMShsm backups, the restore skeleton that matches the product identifier of the backup checks for the existence of the CNEWUNIT variable and uses it if available. The CNEWUNIT variable contains the name of the new unit entered through the panel interface.


Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwug/dwwug00038.html