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.