Restore and retrieve processing options
You can use client options to control some aspects of restore and retrieve processing.
Table 1 lists the restore and retrieve processing options that are available.
| Option | Description |
|---|---|
asrmode |
Use this option with the restore, and restore systemstate commands
to specify whether to perform a restore operation in system ASR recovery
mode. This option is used in the context of restore commands that
are generated in the asr.sif file by the backup asr command only. Do not use this option outside
the context of ASR recovery mode. |
backupsetname |
The backupsetname option specifies either the name of the backup set, or the name
of the file or tape device that contains the backup set. This option
is used with the location option. |
| dirsonly | Qualifies the operation (backup, archive, restore, retrieve) to process directories alone. |
| disablenqr | Specifies whether the backup-archive client can use the no-query restore method for restoring files and directories from the server. |
| filelist | Specifies a file that contains a list of files to be processed by the specified command. |
| filesonly | Qualifies the operation (backup, archive, restore, retrieve) to process files alone. |
![]() ![]() ![]() followsymbolic |
![]() ![]() ![]() Specifies whether you want to restore
files to symbolic links or use a symbolic link as a virtual mount
point. |
| fromdate | Use the fromdate option with the fromtime option to specify a date and time from which you want to search for backups or archives during a restore, retrieve, or query operation. |
| fromnode | Permits one node to perform commands for another node. A user on another node must use the set access command to give you permission to query, restore, or retrieve files or images for the other node. |
![]() ![]() ![]() fromowner |
![]() ![]() ![]() Displays file spaces for an alternative
owner. Also specifies an alternative owner from which to restore or
retrieve files. |
| fromtime | Use the fromtime option with the fromdate option to specify a beginning time from which you want to search for backups or archives during a restore, retrieve, or query operation. |
| ifnewer | Replaces an existing file with the latest backup version only if the backup version is newer than the existing file. |
![]() ![]() imagetofile |
![]() ![]() Use the imagetofile option with the
restore image command to specify that you want to restore the source image to a
file. You might need to restore the image to a file in the event of bad sectors present on the
target volume, or if you want to do some manipulations with the image data.
This option is valid for
AIX®, Linux®, and Solaris
clients.
|
imagetofile |
Use the imagetofile option with the restore image command to specify
that you want to restore the source image to a file. You might need
to restore the image to a file in the event of bad sectors present
on the target volume, or if you want to do some manipulations with
the image data. |
| inactive | Displays a list of active and inactive files when used with the pick option. |
| latest | Restores the most recent backup version of a file whether it is active or inactive. |
| localbackupset | Specifies whether the backup-archive client GUI bypasses initial logon with the server to restore a local backup set on a stand-alone workstation. |
![]() ![]() makesparsefile (does not apply to Mac OS X) |
![]() ![]() Use the makesparsefile option with the restore or retrieve commands to specify how sparse files are re-created. |
![]() ![]() ![]() monitor |
![]() ![]() ![]() Specifies whether you want to monitor
an image restore of one or more file systems that belong to a network-attached
storage (NAS) file server. |
noprompt |
suppresses the confirmation prompt
that is presented by the delete group, delete archive, expire, and set event commands. |
![]() ![]() ![]() noprompt |
![]() ![]() ![]() suppresses the confirmation prompt
that is presented by the delete group, delete archive, expire, restore
image, and set event commands. |
optfile |
Specifies the client options file you want to use when you start a
backup-archive client session. |
![]() ![]() ![]() optfile |
![]() ![]() ![]() Specifies the client user-options file that you want to use when
you start a backup-archive client session. |
| pick | Creates a list of backup versions, images, or archive copies that match the file specification you enter. From the list, you can select the versions to process. Include the inactive option to view both active and inactive objects. |
| pitdate | Use the pitdate option with the pittime option to establish a point in time for which you want to display or restore the latest version of your backups. |
| pittime | Use the pittime option with the pitdate option to establish a point in time for which you want to display or restore the latest version of your backups. |
| preservepath | Specifies how much of the source path to reproduce as part of the target directory path when you restore or retrieve files to a new location. |
| replace | Specifies whether to overwrite an existing file, or to prompt you for your selection when you restore or retrieve files. |
![]() ![]() ![]() showmembers (does not apply to Mac OS X) |
![]() ![]() ![]() Displays all members of a group. |
| subdir | Specifies whether you want to include subdirectories of a named directory. |
| tapeprompt | Specifies whether you want the backup-archive client to wait for a tape that is required for a restore or retrieve to be mounted, or to prompt you for your choice.0387 |
| todate | Use the todate option with the totime option to specify an ending date and time to which you want to search for backups or archives during a restore, retrieve, or query operation. |
| totime | Use the totime option with the todate option to specify an ending date and time to which you want to search for backups or archives during a restore, retrieve, or query operation. |
| type | Use the type option with the query node command to specify the type of node to query. |
![]() ![]() verifyimage |
![]() ![]() Use the verifyimage option with the
restore image command to specify that you want to enable detection of bad sectors
on the destination target volume. If bad sectors are detected on the target volume, the client
issues a warning message on the console and in the error log. |
verifyimage |
Use the verifyimage option with the
restore image command to specify that you want to enable detection of bad sectors
on the destination target volume. If bad sectors are detected on the target volume, the client
issues a warning message on the console and in the error log. |
The following options are backup-archive client options that apply to IBM Storage Protect HSM for Windows migrated files. For more information about
these options, see the IBM Documentation topics at IBM Storage Protect HSM for Windows .
- Checkreparsecontent
- Restorecheckstubaccess
- Restoremigstate
- Skipmigrated
The following options are backup-archive client options that apply to IBM Storage Protect for Space Management migrated files. For more information about these
options, see the IBM Documentation topics at IBM Storage Protect for Space Management .
- Restoremigstate
- Skipmigrated




