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.

Table 1. Restore and retrieve processing options
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 Tivoli® Storage Manager 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.
guitreeviewafterbackup	Specifies whether the client GUI is returned to the Backup, Restore, Archive, or Retrieve window after a successful operation completes.
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 only valid for AIX®, HP-UX, Linux x86_64, Linux on Power®, 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 Tivoli Storage Manager 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 Tivoli Storage Manager session.
optfile	Specifies the client user-options file that you want to use when you start a Tivoli Storage Manager 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 Tivoli Storage Manager to wait for a tape that is required for a restore or retrieve to be mounted, or to prompt you for your choice.
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, Tivoli Storage Manager 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, Tivoli Storage Manager issues a warning message on the console and in the error log.

The following options are backup-archive client options that apply to IBM® Tivoli Storage Manager HSM for Windows migrated files. For more information about these options, see the IBM Knowledge Center topics at http://www.ibm.com/support/knowledgecenter/SSATMW.

Checkreparsecontent
Restorecheckstubaccess
Restoremigstate
Skipmigrated

The following options are backup-archive client options that apply to IBM Tivoli Storage Manager for Space Management migrated files. For more information about these options, see the IBM Knowledge Center topics at http://www.ibm.com/support/knowledgecenter/SSSR2R.

Restoremigstate
Skipmigrated