Tivoli Header

Tivoli Storage Manager for NetWare Backup-Archive Client Installation and User's Guide

Retrieve

The retrieve command obtains copies of archived files from the Tivoli Storage Manager server. You can retrieve specific files or entire directories. Use the description option to specify the descriptions assigned to the files you want to retrieve.

You can also use the pick option to display a list of your archives. From this list, you can select an archive to retrieve.

Retrieve the files into the same directory from which they were archived, or in a different directory. Tivoli Storage Manager uses the preservepath option with the subtree value as the default for restoring files. For more information, see Chapter 10, "Using Options with Commands".

Note:
If you are retrieving files to a different directory than the original directory, file names become the names you specify with the destinationfilespec parameter. Because only DOS names are valid within the client, the file name becomes a DOS name.

Syntax

                           .----------------------.
                           V                      |
>>-RETrieve--+----------+----+-sourcefilespec---+-+------------->
             '- options-'    '-DIRectory or NDS-'
 
>--+----------------------+------------------------------------><
   '- destinationfilespec-'
 
 

Parameters

options
You can use these command line options with the retrieve command: description, dirsonly, filelist, filesonly, fromdate, fromnode, fromtime, ifnewer, pick, pitdate, preservepath, todate, totime. For more information, see Chapter 10, "Using Options with Commands".

For information about common options you can use with the retrieve command, see Chapter 9, Using Processing Options.

sourcefilespec
Specifies the path and file name that you want to retrieve. Use wildcard characters to specify a group of files or all the files in a directory. See Maximum File Size for Operations for the maximum file size for retrieve processing.

DIRectory or NDS
Retrieves the NDS.

destinationfilespec
Specifies the path and file name where you want to retrieve the files to. The path and file name must follow DOS naming conventions. If you do not specify a destination, Tivoli Storage Manager restores the files to the original source path.

Examples

Task
Retrieve a single file named budget.

Command: dsmc ret sys:projecta/budget

Task
Retrieve all files with an extension of .bak from the sys:projecta directory.

Command: dsmc retrieve sys:projecta/*.bak

Task
Retrieve files in the sys:project directory. Use the pick option.

Command: dsmc ret sys:project/* -pick

Task
Retrieve all files from the sys:projecta directory that end with the characters .bak to the sys:projectn/ directory.

Command: dsmc ret/projecta/*.bak servb\sys:projectn/

Note:
If the destination is a directory, you must specify the delimiter (/) as the last character of the destination. If you omit the delimiter and your specified source is a directory or a file spec with a wildcard, you will receive an error.

Task
Retrieve all files in the sys:home directory.

Command: dsmc retrieve sys:home/*

Note:
To retrieve files contained in a subdirectory, you must specify the subdirectory in another retrieve command.

Task
Retrieve files in the sys:project directory. Use the pick option.

Command: ret sys:project/* -pick


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