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 the CICS® VR Implementation Guide and Reference for further information about backup notification, backup registration, and restore skeletons.

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 CICS® VR Implementation Guide and Reference 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.