The VRECOVER command syntax is:
VRECOVER SIM,VOLUMES=,TOVOLUME=,VERSION=,TIMEDATE=,UPDATE,DSNENQ=,RESERVE=,
GOAHEAD=,IDVOL=,CYL0TRK0=,SECERASE,ABSTRKS=,RPT=
This parameter causes processing to appear to take place; however, no data sets will be altered. Messages will be issued as if normal volume-level recover processing were taking place.
Specify NOADMIN to bypass the use of Storage Administration FACILITY Class Profiles for this command. This VRECOVER command will only make use of the standard security access for the user submitting the job.
Specify for this required parameter a list of one or more volumes to be recovered. (A maximum of 50 entries is supported). If you specify more than one volume for this parameter, you cannot specify the TOVOLUME=, IDVOL= or ABSTRKS= parameters on the same VRECOVER command.
The volume to which the volume-level recover is directed. If this parameter is not specified, CA Disk will use the volume(s) specified in the VOLUMES= parameter. If the VOLUMES= parameter specifies more than one volume and this parameter is also specified, the command will be rejected.
The VERSION= parameter is mutually exclusive with the TIMEDATE= parameter, and has the same meaning as defined for the RESTORE command.
The TIMEDATE= parameter is mutually exclusive with the VERSION= parameter, and has the same meaning as defined for the RESTORE command.
This optional parameter indicates that any data set changed after the volume-level backup being used for this VRECOVER was taken will subsequently be updated (recovered) from its data set-level backup; that is, recover the data set from the incremental backup copy after the volume-level recovery is complete. CA Disk internally generating and executing the data set-level RECOVER command accomplishes this. The parameters that are generated for the RECOVER command are:
RECOVER VOL=,TOV=,DATE=,TIME=,SCRATCH,NOC,(SIM)
The parameter values generated for VOL= and TOV= are the same as those specified on the VRECOVER command. CA Disk obtains the DATE= and TIME= values from the DSNINDEX record of the volume-level backup being used. If the VRECOVER command is submitted with the SIMULATE parameter specified, the RECOVER command will be generated in SIMULATE mode as well.
By generating this RECOVER command, CA Disk allows you to first recover the entire volume from a volume-level backup, then follow immediately with updates from incremental backups. CA Disk will select the data sets needing to be restored based on the DATE and TIME values generated on the RECOVER command. To be effective, your installation should schedule volume-level backup runs to follow incremental backups. This is because the incremental backup turns off the change bit for updated data sets, thus reducing the number of data sets needing to be restored after the volume-level recover is complete.
The DSNENQ= parameter has a default value of EXC, which causes CA Disk to issue an exclusive enqueue for every data set on the volume. If you specify a value of NONE, no enqueues are issued for the data sets. A value of SHR causes shared enqueues to be issued.
The RESERVE= parameter defaults to YES, and issues a hardware reserve and VTOC enqueue. If you specify a value of NO, no hardware reserve or VTOC enqueue are issued.
Note: Using the defaults for the DSNENQ= and RESERVE= parameters will prevent any updates to the volume during VRECOVER processing.
This parameter controls processing only when an enqueue cannot be obtained or if the hardware reserve fails. The default value is OPERATOR, which causes a message to be issued on the console notifying the operator of the enqueue or reserve that failed, and giving the operator the options to LIST, CONTINUE or CANCEL. If the operator responds LIST, CA Disk will display at the operator's console a list of the data sets for which the enqueue or reserve failed.
If you specify a value of CONTINUE on this parameter (or if the operator replies CONTINUE), CA Disk will continue processing. If you specify a value of CANCEL (or if the operator replies CANCEL), CA Disk will issue a message and terminate VRECOVER processing.
The IDVOL= parameter controls the volume name CA Disk assigns to the target volume. The default value (not specifying this parameter) causes CA Disk to retain the original name of the volume. If you specify a different volume name for this parameter, CA Disk will rename the target volume. (This is sometimes referred to as "clipping" the volume.)
This parameter applies only to a full volume-level recovery; that is, it is mutually exclusive with the ABSTRKS= parameter described in the following section.
Note: The volume name specified must not exist in the system at the time the process is initiated
The CYL0TRK0= parameter controls the recovery of the data records, if present, on cylinder 0, track 0. This track is a reserved track on each volume containing a pointer to the VTOC, the volume serial, and other optional data. It often includes IPL text.
When a volume-level recovery is performed, the pointer to the VTOC is always updated to reflect its location on the recovered volume. The default value of YES for this parameter causes all data records on this track to be recovered from the backups. If you specify a value of NO, only the VTOC pointer is updated (and the volume serial, if it is being renamed).
This parameter applies only to a full volume-level recovery; that is, it is mutually exclusive with the ABSTRKS= parameter described in the following section.
If you specify this simple parameter, CA Disk will zero all tracks on the target volume not recovered.
This parameter applies only to a full volume-level recovery; that is, it is mutually exclusive with the ABSTRKS= parameter described as follows:
ABSTRKS= This parameter can be specified to overlay only a range of absolute tracks rather than the full volume. ABSTRKS= is mutually exclusive with the UPDATE, IDVOL=, CYL0TRK0=, and SECERASE parameters. If the VOLUMES= parameter specifies more than one volume and this parameter is also specified, the command will be rejected.
When this parameter is specified, the DSNENQ processing is also bypassed.
Specify this parameter in the following format:
ABS=(cccchhhh-cccchhhh,...)
Or
ABS=(cccCCCC:H-cccCCCC:H,…)
Each pair indicates a beginning and ending range of tracks in absolute address format. The range of tracks will be recovered without regard to any data set checking.
The format of cccchhhh is the format that the hardware writes the CCHH field in. For non-Extended Address Volumes (EAV), the cccc is the cylinder number (where the cylinder number is less than or equal to hexadecimal FFFF) and the hhhh portion is the head number in the range of hexadecimal 0000 to 000E. The format of cccCCCC:H is the format used to specify the logical cylinder number for both EAV and non-EAV devices. For non-EAV devices the range of value for the cccCCCC cylinder number will be from hexadecimal 0000000 to 000FFFF (from 0 to 65,535). For EAV devices, the range will be hexadecimal 0000000 to FFFFFFF (from 0 to 268,435,455). A value larger than the device size will be rejected with a message numbered 3240. The H portion of the address is the head number and may range from hexadecimal 0 to E (0 to 14). Each address pair must use the same format but individual pairs may be of either format.
If cylinder 0 track 0 is one of the absolute tracks to be recovered, the TOVOLUME= volume serial is placed in the volume serial field before the remainder of the track is written.
This parameter can be specified with a value of MAP to cause CA Disk to produce a VTOC MAP report at the end of the volume-level recovery. If the default value NONE is specified or the Simulate parameter is present, no report is produced.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|