Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients

dsmrecall

Attention: On large file systems, selective recall can take a long time.

The dsmrecall command selectively recalls migrated files to your local file system. Space management must be active.

If the file resides in a file system whose server stanza is different from that of the last processed file, a new session is started for each file that is recalled. This can happen as a result of links from one file system to another.

For AIX JFS file systems: When you selectively recall a file, you override the migrate-on-close or read-without-recall modes that you set for a migrated file. The file is recalled to its originating file system.

To display a list of all your migrated files, use the dsmmigquery command. To display information about a list of migrated files from a particular file system or directory, use the dsmls command.

Syntax

                                .---------------.
                                V               |
>>-dsmrecall--+--------------+------ filespec---+--------------><
              | .----------. |
              | V          | |
              '--- options-+-'
 
 

Parameters

Options

-Recursive or -r
Recalls files that match the file specification in a directory and its subdirectories. If you do not use this option, files are recalled only for those directories that you specify.

-Detail or -v
Displays the size, path, and file name for each file that you recall.

filespec
The path and file name of the file that you want to recall. This parameter is required. You can use wildcard characters to specify a group of files or all files in a directory, or you can enter more than one file specification in one command. When you use wildcard characters in a file specification, the HSM client attempts to recall all files that match the specification. If a file matches the specification but it is not migrated, an error message displays. If you enter more than one file specification, separate each specification with at least one blank space.

Examples

Task Command
Recall a single file named /migfs1/test/tf04 and display detailed information. dsmrecall -Detail /migfs1/test/tf04
Recall all migrated files in a directory named /mfs4/user1 and all migrated files in its subdirectories. dsmrecall -Recursive /mfs4/user1/*


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