Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients

dsmmigrate

For AIX GPFS and Solaris VxFS file systems: You must have root user authority to use this command.

Attention: On large file systems, selective migration can take a while.

The dsmmigrate command selects specific files from your local file system and migrates them to a TSM server.

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

Note:
If you set the tapeprompt option to yes in your dsm.opt file, and the destination for your migrated file is a storage pool that consists of removable media such as tape, you are prompted either to wait for the medium to mount, or to skip the file.

The first file migrates even if the file size exceeds the quota that you specified for the file system. When migration occurs, the ddf command displays zero migrated and premigrated bytes for your file system. If the total number of bytes exceeds the quota after the file migrates, the next file is not migrated.

Syntax

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

Parameters

Options
Select any of these options:

-Recursive or -r
Migrates files in any subdirectory below the specified directory that match the file specification. If you do not use this option, only those files from the directories that you specify are migrated.

-Detail or -v
Displays the size and file name for each file that you migrate.

filespec
The path and file name of the file that you want to migrate. 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. If you enter more than one file specification, separate each specification with one or more blank spaces.

Examples

Task Command
Migrate all files in a directory named /migfs2/test/dir1 and in all of its subdirectories. Display the information. dsmmigrate -Rv /migfs2/test/dir1
Migrate a file named tf04 from the current directory and display the information. dsmmigrate -Detail tf04


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