Tivoli Storage Manager for Windows Using the Backup-Archive Client


Chapter 9. Using Options With Commands

The client program includes a group of client command options that you can enter with specific commands only from the command line. You can also enter common options to override many of the options set in your client options file. Options are processed following this precedence (order):

  1. Options defined on the server with server-enforced client options. The client cannot override the value.
  2. Options entered locally on the command line.
  3. Options defined on the server for a schedule using the options parameters.
  4. Options entered locally in the options file.
  5. Options received from the server with client options not enforced by the server. The client can override the value.
  6. Default option values.

For a complete list of client command options, their descriptions, the commands with which you can use them, and the location in this book for more information, see Table 27. For a complete list of common options, see Chapter 8, "Setting Common Options".


Entering Options With a Command

Follow these general rules when you enter options with a command:


Table 27. Client Command Options

Command Option Description Commands Page
archmc Overrides the default management class for a file or a group of files. archive Archmc
deletefiles Deletes the local copy of files from your workstation after they are archived on the server.
archive

Deletefiles
deletefiles Deletes the local copy of files from your workstation after they are archived on the server.
archive

Deletefiles
description Specifies a description for a file that you are archiving, deleting, or retrieving. Also specifies the description of a backupset that you want to query.
archive
delete archive
query archive
query backupset
retrieve

Description
detail Displays management class attributes for available management classes. query mgmtclass Detail
dirsonly Backs up, restores, archives, retrieves, or displays directories only.
archive
incremental
query archive
query backup
restore
retrieve
selective

Dirsonly
filesonly Backs up, restores, retrieves, or displays files only.
incremental
query archive
query backup
restore
retrieve
selective

Filesonly
fromdate Sets a date limit for files. Tivoli Storage Manager does not include files processed before this date, although older directories might be included.

This option is ignored if the nobase option is absent.


query archive
query backup
restore
retrieve




Fromdate
fromnode Displays file spaces for an alternate node. Also specifies an alternate node from which to restore or retrieve files.
query archive
query backup
query filespace
query mgmtclass
restore
retrieve




Fromnode
fromtime Specifies a beginning time on the specified date. Use with the fromdate option. This option is ignored if the fromdate and nobase optionsare absent.
query archive
query backup
restore
retrieve

Fromtime
ifnewer Replaces existing files with the latest backup version only if the backup version is newer than the existing version.
restore
restore backupset
retrieve

Ifnewer
inactive Processes inactive backup versions of files.
query backup
restore




Inactive
incrbydate Requests an incremental backup by date. incremental Incrbydate
latest Restores the most recent backup version of a file whether it is active or inactive. restore Latest
location Specifies whether to locate backup sets on the server or in local files.
query backupset
restore backupset

Location
noprompt Suppresses the confirmation prompt when deleting an archived file. delete archive Noprompt
pick Displays a list of files from which you can select files to delete, restore, or retrieve.
delete archive
restore
retrieve



Pick
pitdate Specifies the file backup date to use when Tivoli Storage Manager selects files to restore. Use with the pittime option.
query backup
restore

Pitdate
pittime Specifies a point in time on the specified date. Use with the pitdate option. This option is ignored if the pitdate option is absent.
query backup
restore

Pittime
preservepath Specifies how the restore directory path is built.
restore
restore backupset
retrieve

Preservepath
restart Restarts the RSM server after files are restored. restore rsm Restart
todate Sets a date limit for files. Tivoli Storage Manager does not include files that are processed after this date. Use with the totime option.
query archive
query backup
restore
retrieve

Todate
totime Specifies an ending time on the specified date. Use with the todate option. This option is ignored if the todate option is absent.
query archive
query backup
restore
retrieve

Totime

Archmc

The archmc option specifies the available management class for a file or a group of files in the active policy set of your policy domain to which you want to bind your archived files.

Syntax

>>-ARCHMc- managementclass-------------------------------------><
 

Parameters

managementclass
Specifies an available management class in the active policy set of your policy domain. This management class overrides the default management class for the files you are archiving.

Examples

Command line:
dsmc archive -archmc=RET2YRS c:\plan\proj1\
budget.jan\*

Deletefiles

The deletefiles option can be used with the archive command to delete archived files from your workstation after they are archived on the server.

Syntax

>>-DELetefiles-------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc archive c:\foo\*.c -deletefiles

Description

The description option assigns or specifies a description for files on which you are performing archive, delete, retrieve, or query archive functions. You can also use this option to specify the description of a backup set that you want to query. For example, if you want to archive a file named budget.jan and assign to it the description 1999 Budget for Proj 1, you would enter:

   dsmc archive -des="1999 Budget for Proj 1" c:\plan\proj1\budget.jan

Syntax

>>-DEScription- description------------------------------------><
 

Parameters

description
Assigns a description to the file you are archiving. If a description is not provided, the default is archive date:x, where x is the current system date.

If you use the archive command to archive more than one file, the description you enter is assigned to each of the files. For example, to archive a group of files and assign the same description, Project X, to each file, you would enter:

   dsmc archive -description="Project X" c:\allproj\*.x

You can then use the description to retrieve all of the files.

Examples

Command line:
dsmc archive -des="1999 Budget for Proj 1" c:\foo\
*.prj

Detail

The detail option displays detailed information about each management class in your active policy set. If you do not use the detail option, only the management class name and a brief description are displayed. If you specify the detail option, information is displayed about attributes in each copy group contained in each management class. A management class can contain a backup copy group, an archive copy group, both, or neither.

Syntax

>>-DETail------------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc query mgmtclass -detail

Dirsonly

The dirsonly option processes directories only. Files are not processed.

Syntax

>>-DIrsonly----------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc query backup -dirsonly *

Filesonly

The filesonly option processes files only. Directories are not processed. When the filesonly option is used with either the restore or retrieve command, directories are not sent from the server. However, directories with default attributes are created, if required, as placeholders for files that are being restored or retrieved.

Syntax

>>-FILESOnly---------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command Line:
dsmc incremental -filesonly

Fromdate

The fromdate option specifies a date from which you want to search for backed up or archived files. Files that were backed up or archived before this date are not included, although older directories might be included, if necessary, to restore or retrieve the files.

When used with nobase option, fromdate provides the start time for applying incremental updates to a specified file system. If nobase is not specified, fromdate is ignored.

Syntax

>>-FROMDate- date----------------------------------------------><
 

Parameters

date
Specifies the date from which you want to search for backup copies or archived files. Enter the date in the format you selected with the dateformat option.

When you include dateformat with a command, it must precede the fromdate, pitdate, and todate options.

Examples

Command line:
dsmc query backup -fromdate=12/11/1999

Fromnode

The fromnode option permits one node to perform commands for another node. A user on another node must use the set access command to permit you to query, list, restore, or retrieve files for that other node.

Syntax

>>-FROMNode- node----------------------------------------------><
 

Parameters

node
Specifies the node name on a workstation or a file server whose backup copies or archived files you want to access.

Examples

Command line:
dsmc query archive -fromnode=bob -subdir=yes

Fromtime

The fromtime option, used with the fromdate option, specifies a beginning time. This option is ignored if the fromdate option is not specified.

When used with nobase option, fromtime provides the start time for applying incremental updates to a specified file system. If nobase is not specified, fromtime is ignored.

Syntax

>>-FROMTime- time----------------------------------------------><
 

Parameters

time
Specifies a beginning time on a specific date. If you do not specify a time, the time defaults to 23:59:59. Specify the time in the format you selected with the timeformat option.

When you include the timeformat option in a command, it must precede the fromtime, pittime, and totime options.

Examples

Command line:
dsmc q b -fromt=11:59AM -fromd=06/30/99 -tot=11:59PM -tod=06/30/99

Ifnewer

The ifnewer option replaces an existing file with the backup if the backup is newer than the existing file. Only active backups are considered unless you also use the inactive or latest options.

Note:This option is ignored if the replace option is set to No.

Syntax

>>-IFNewer-----------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc restore -ifnewer

Inactive

The inactive option is used with the restore and query backup commands, and the pick option, to display active and inactive objects.

You can also use the pick option to display backup versions, archive copies that match the file specification you enter.

Only active backups are considered unless you also use either the inactive or the latest option.

Syntax

>>-INActive----------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc restore -inactive c:\id\projecta\

Incrbydate

Important:It is recommended that if you have limited time during the week to perform backups, but extra time on weekends, you may want to maintain current server storage of your workstation files by performing a partial incremental backup on weekdays, and a full incremental backup on weekends.

The incrbydate option is used with the incremental command to backup up new and changed files with a modification date later than the last incremental backup stored at the server, unless the file is excluded from backup. Files added at the client after the last incremental backup, but with a modification date earlier than the last incremental, are not backed up

An Incremental-by-date updates the date and time of the last incremental at the server. If an incremental-by-date is performed on only part of a file system, the date of the last full incremental is not updated, and the next incremental-by-date will back up these files again.

Both full and partial incrementals back up new and changed files. An incremental-by-date takes less time to process than a full incremental, and requires less memory. However, unlike a full incremental, an incremental-by-date does not maintain current server storage of all your workstation files because:

Syntax

>>-INCRbydate--------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc incremental -incrbydate

Latest

The latest option is used with the restore command to restore the most recently backed up version of a file, even if the backup is inactive. Only active versions are considered for a restore unless you use either the inactive or the latest option.

Syntax

>>-LATest------------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc restore c:\devel\projecta\ -latest

Location

The location option specifies where TSM searches for the backup set for a query or restore operation. You can use this option to locate backup sets on the server or local files. Tapes that are generated on the server can be used locally by specifying location option and either the file name or the tape device.

Syntax

            .-server--.
>>-LOCation-+---------+----------------------------------------><
            +-file----+
            '-tape----'
 

Parameters

server
Specifies that TSM searches for the backup set on the server. This is the default.

file
Specifies that TSM searches for the backup set on a local file.

tape
Specifies that TSM searches for the backup set on a local tape device. This parameter is valid for Solaris, AIX, HP-UX, Windows NT, and Windows 2000 clients. The supported tape devices are the following:

Notes:

  1. 8mm

  2. 4mm

  3. DLT

  4. 3570

  5. 3590

Examples

Command line:
dsmc restore backupset mybackupsetname -loc=server 

Noprompt

Use this option with caution.

The noprompt option suppresses the confirmation prompt that normally appears before an archived file is deleted. Using this option can speed up the delete procedure. However, it also increases the danger of accidentally deleting an archived file that you wanted to save.

Syntax

>>-NOPrompt----------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc delete archive -noprompt c:\home\project\*

Pick

The pick option displays a list of backup versions or archive copies that match the file specification you enter. From the list, you can select the versions to process. Select the inactive option to view both active and inactive objects.

Syntax

>>-PIck--------------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

Command line:
dsmc restore c:\project\* -pick -inactive

Pitdate

The pitdate option, used with the pittime option, establishes a point in time for which you want to display or restore the latest version of your backups. Files that were backed up on or before the date and time you specified, and which were not deleted before the date and time you specified, are processed. Backup versions that you create after this date and time are ignored.

Syntax

>>-PITDate- date-----------------------------------------------><
 

Parameters

date
Specifies the appropriate date. Enter the date in the format you selected with the dateformat option.

When you include dateformat with a command, it must precede the fromdate, pitdate, and todate options.

Examples

Command line:
dsmc restore -pitdate=08/01/1999

Pittime

The pittime option, used with the pitdate option, establishes a point in time for which you want to display or restore the latest version of your backups. Files that were backed up on or before the date and time you specified, and which were not deleted before the date and time you specified, are processed. Backup versions that you create after this date and time are ignored. This option is ignored if the pitdate option is not specified.

Syntax

>>-PITTime- time-----------------------------------------------><
 

Parameters

time
Specifies a time on a specified date. If you do not specify a time, the time defaults to 23:59:59. Specify the time in the format you selected with the timeformat option.

When you include the timeformat option in a command, it must precede the fromtime, pittime, and totime options.

Examples

Command line:
dsmc query backup -pitt=06:00:00 -pitd=08/01/1999

Preservepath

The preservepath option 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. Use the -subdir=yes option setting to include the entire subtree of the source directory (directories and files below the lowest-level source directory) as source to be restored. If a required target directory does not exist, it is created. If a target file has the same name as a source file, it is overwritten. Use the -replace=prompt option setting to have Tivoli Storage Manager prompt you before files are overwritten.

Syntax

                .-subtree--.
>>-PRESERvepath-+----------+-----------------------------------><
                +-complete-+
                +-nobase---+
                '-none-----'
 

Parameters

subtree
Creates the lowest-level source directory as a subdirectory of the target directory. Files from the source directory are stored in the new subdirectory. This is the default.

complete
Restores the entire path, starting from the root, into the specified directory. The entire path includes all the directories except the file space name.

nobase
Restores the contents of the source directory without the lowest level, or base directory, into the specified destination directory.

none
Restores all selected source files to the target directory. No part of the source path at or above the source directory is reproduced at the target.

If you specify subdir=yes, all files in the source directories are restored to the single target directory.

Examples

Command line:
For the examples below, assume the server file space contains the following backup copies:
c:\h1\m1\file.a
c:\h1\m1\file.b
c:\h1\m1\l1\file.x
c:\h1\m1\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -preservep=complete.

Restores these directories and files:

c:\ann\h1\m1\file.a
c:\ann\h1\m1\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -preser=nobase.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -preser=subtree.

Restores these directories and files:

c:\ann\m1\file.a
c:\ann\m1\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -preser=none.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=
complete

Restores these directories and files:

c:\ann\h1\m1\file.a
c:\ann\h1\m1\file.b
c:\ann\h1\m1\l1\file.x
c:\ann\h1\m1\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=nobase.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b
c:\ann\l1\file.x
c:\ann\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=subtree.

Restores these directories and files:

c:\ann\m1\file.a
c:\ann\m1\file.b
c:\ann\m1\l1\file.x
c:\ann\m1\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=none.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b
c:\ann\file.x
c:\ann\file.y

This command:
dsmc res backupset c:\h1\m1\ c:\ann\ -su=yes 
-preser=nobase -loc=file

.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b
c:\ann\file.x
c:\ann\file.y

Restart

The restart option specifies whether Tivoli Storage Manager should restart the RSM server after restoring the RSM database. During the back up process, Tivoli Storage Manager creates a replica of the current database and backs up the database to the server. During the restore, files are restored from the server then imported to the RSM database. You can restart the RSM server immediately by using the restart option on the restore rsm command, or wait until the next scheduled restart for the updates to become effective.

Note:This option is for Windows NT and Windows 2000 servers, only.

Syntax

>>-RESTART-----------------------------------------------------><
 

Parameters

There are no parameters for this option.

Examples

To restart the RSM server automatically after restoring the RSM database, enter the following command:

Command Line:
restore rsm -restart

Todate

The todate option, used with the totime option, specifies an ending date and time. For example, you might request a list of files that were backed up before 11:59 PM on June 30, 1999.

Use the todate and totime options with the fromtime and fromdate options to request a list of backed up or archived files within a period of time. For example, you might request a list of files that were backed up between 6:00 AM on July 1, 1999 and 11:59 PM on July 30, 1999.

Syntax

>>-TODate- date------------------------------------------------><
 

Parameters

date
Specifies an ending date. Enter the date in the format you selected with the dateformat option.

When you include dateformat with a command, it must precede the fromdate, pitdate, and todate options.

Examples

Command line:
dsmc restore -todate=12/11/1999

Totime

The totime option, used with the todate option, specifies an ending time on a specified date. For example, you might request a list of files that were backed up before 11:59 PM on June 30, 1999. This option is ignored if the todate option is not specified.

Use the totime and todate options with the fromtime and fromdate options to request a list of files that were backed up within a period of time. For example, you might request a list of files that were backed up between 6:00 AM on July 1, 1999 and 11:59 PM on July 30, 1999.

Syntax

>>-TOTime- time------------------------------------------------><
 

Parameters

time
Specifies an ending time. If you do not specify a time, the time defaults to 23:59:59. Specify the time in the format you selected with the timeformat option.

When you include the timeformat option in a command, it must precede the fromtime, pittime, and totime options.

Examples

Command line:
dsmc restore -totime=23:00:00 -todate=09/17/1999


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]