Tivoli Header

Tivoli Storage Manager for UNIX Backup-Archive Clients Installation and User's Guide

Selective

The selective command backs up files that you specify. If these files become damaged or lost, you can replace them with backup versions from the server. When you run a selective backup, all the files are candidates for back up unless they are excluded from backup in your include-exclude list, or they do not meet management class requirements for serialization.

During a selective backup, copies of the files are sent to the server even if they did not change since the last backup. This might result in more than one copy of the same file on the server. If this occurs, you might not have as many different down-level versions of the file on the server as you intended. Your version limit might consist of identical files. To avoid this, use the incremental command to back up only new and changed files.

You can selectively back up single files or directories. You can also use wildcard characters to back up groups of related files.

If you set the subdir option to yes when backing up a specific path and file, Tivoli Storage Manager recursively backs up all subdirectories under that path, and any instances of the specified file that exist under any of those subdirectories.

During a selective backup, a directory path may be backed up, even if the specific file that was targeted for backup is not found. For example:

   selective "/dir1/dir2/bogus.txt"

still backs up dir1 and dir2 even if the file bogus.txt does not exist.

If the selective command is retried because of a communication failure or session loss, the transfer statistics will display the number of bytes Tivoli Storage Manager attempts to transfer during all command attempts. Therefore, the statistics for bytes transferred may not match the file statistics, such as those for file size.

Supported Clients

This command is valid for all UNIX clients.

Syntax

                            .-----------------.
                            V                 |
>>-SELective--+----------+----+- filespec---+-+----------------><
              '- options-'    '- "filespec"-'
 
 

Parameters

options
You can use these command line options with the selective command: changingretries, dirsonly, filesonly, volinformation, filelist, tapeprompt, subdir. For more information, see Chapter 10, "Using Options with Commands".

You can use the quiet common option with the selective command. See Chapter 9, Setting Processing Options for information about common options.

filespec
Specifies the path and file name that you want to back up. Use wildcard characters to select a group of files or all the files in a directory. You can enter up to 20 file specifications in a command, separating the file specifications with a space. When backing up a file system, specify the file system with a trailing slash; for example: /home/.

Examples

Task
Back up the proja file in the /home/devel directory.

Command: selective /home/devel/proja

Task
Back up all files in the /home/devel directory whose file names begin with proj.

Command: selective "/home/devel/proj*"

Task
Back up all files in the /home/devel directory whose file names begin with proj. Back up the single file named budget in the /user/home directory.

Command: selective "/home/devel/proj*" /user/home/budget

Task
Back up the /home file system.

Command: selective /home/


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