The RESTORE command syntax is:
Specify this parameter if the creation date for the data set being restored is to be set equal to the current date. Default processing leaves the original creation date unaltered.
Enter the full explicit name of the non-VSAM data set, VSAM cluster, physical alternate index, or uncataloged GDG entry to be restored.
Note: If the GDG name is currently cataloged, relative GDG names (for example, -2) are permitted. However, uncataloged versions are not locatable by version number and will be skipped even if the DSNINDEX record exists. It is recommended that if you uncatalog GDGs (for example, DISP=UNCAT) during archive, that you specify the fully qualified GDG entry name (for example, A.B.C.Gnnnvnn suffix during RESTORE).
To restore alternate indexes based on the catalog information archived with a base cluster, enter the base cluster's name, not the alternate index names.
To restore an OS CVOL catalog, it must be given the name SYSCTLG in order to do proper formatting. Current support also requires that SYSCTLG be restored to the same device type from which it was archived.
The data set name to be assigned to the restored data set or cluster. A maximum of one entry is supported.
For GDGs, a relative GDG name can be specified.
For VSAM, this name applies only to the primary base cluster or alternate index being restored. If the data (and for a KSDS, the index also) component was originally assigned a name by Access Method Services, CA Disk will let AMS generate a new name for the component(s) again (unless sysparms VSAPPEND, VSDATSUF, or VSINXSUF are specified).
If the component name(s) were originally specified by the user, CA Disk will assign new names to the data and index components based on the differences detected between the original base cluster and the new name specified on the command. The data and index names can also be explicitly specified on the DNAME and INAME parameters.
If a base cluster is being restored (AIXNAME parameter is not specified) that had alternate index associations, the new name specified is the one to be given the base cluster. CA Disk will generate names for its alternate index(es) and path(s).
Note: Default action causes CA Disk to use the Base Cluster or AIX new name, depending on the path entry alignment, and appends .PATH to the PATH as the LLQ. If you require that only the HLQ be changed and the LLQ left unchanged, use sysparm NEWPATHN. For details, see NEWPATHNy in the Systems Guide.
If an alternate index is being redefined from a catalog definition found with the base cluster (AIXNAME parameter specified), the new name will be given to the alternate index being restored.
The volume serial number of the device to which the data set is to be restored. The restore attempt will be terminated if the allocation cannot be on the specified volume. This parameter is mutually exclusive with the POOL parameter, and a maximum of one entry is supported.
To restore other than the most recent version of the data set contained in the CA Disk archives (either an archived copy or a backup copy), specify from -1 to -99 to get the successively older version of the data set.
This parameter can be used to identify a specific version of the data set within the archives, rather than the relative version as supplied on the VERSION= parameter. Its use would be appropriate if a possibility exists that another version of the same data set will be placed in the archives before the restore can be completed.
The format for this parameter is hhmmdate where hhmm is the 24 hour time and date is any recognized CA Disk date format, described in the section Date Formats in the chapter "General Information." Correct values can be obtained by listing the CA Disk index entries for the data set via either batch or TSO.
Use this parameter to scratch a non-VSAM data set when it exists on the target volume (providing the DSORG of the target data set matches the DSORG of the data set being restored) with the same name that the data set being restored is to have. If sysparm RESCRCAT has a value of Y, CA Disk will attempt to scratch the target data set from its cataloged volume prior to restoration. With sysparm RESCRCAT specified as N, CA Disk will scratch the target data set only if it resides on the same volume to which CA Disk attempted its allocation.
For VSAM, if a cluster already exists in the catalog with the same name that the cluster being restored is to have, CA Disk will delete the target data set name, then reallocate the target data set name and restore the data.
If a partitioned data set is being restored to a preallocated data set, this parameter causes the existing contents to be erased and overlaid with the restored version.
If ERASE is not specified when restoring to a preallocated PDS, sufficient space must be left to load the members following the existing data.
If a VSAM cluster is being restored, this parameter indicates the cluster's data component is to be overwritten with binary zeros when its catalog entry is deleted.
This parameter can be specified on the RESTORE command to indicate that the request is to be queued for later processing. It can be used in lieu of changing the RESTORE command to DRESTORE.
The volume serial number of the device to which the CA Disk DSS data mover backed up data set is to be restored. This parameter is mutually exclusive with the parameters VOL= and TOVOL.
Notes: For the parameter:
Only for DSS restore
Full volume serial numbers; no / or *
Can accept up to 59 volume serial numbers
Specified volumes must be online
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|