dsmautomig

You must have root user authority to use this command.

The dsmautomig command checks:

• If a migration candidate requires a current backup version on the TDP for IBM® Lotus Notes® Tivoli Storage Manager server.
• If a current backup version exists.

If the LANG environment variable is set to C, POSIX, only characters with ASCII codes less than 128 are valid. The HSM client skips files that have file names that contain invalid characters. If you are using a single-byte character set (SBCS) such as English as your language environment, all file names are valid and are migrated by the Tivoli Storage Manager for Space Management client.

Multi-byte characters are interpreted as a set of single bytes all containing valid characters. If you are using multi-byte character sets (MBCS) as your language environment, the HSM client migrates file names that consist of valid characters in the current environment. For example, a file name consisting of Japanese characters might contain invalid multi-byte characters if the current language environment is a Chinese character set. File names containing invalid multi-byte characters are not migrated or recalled. If such files are found during migrate or recall no information is printed. The HSM daemons must run in the en_US language locale to work properly.

Specify the number of parallel migration sessions with the maxmigrators option in your dsm.sys file. Verify that sufficient resources are available on the Tivoli Storage Manager server for parallel migration. Do not set the maxmigrators option higher than the number of sessions that the Tivoli Storage Manager server can use to store data. Start threshold migration manually to reduce space usage on your file system before it reaches the high threshold that you set.

Hidden directories and files are included in automatic migration. Files can be excluded from automatic migration by adding the hidden directories or files to the exclude list in the dsm.opt file.

The scout daemon (dsmscoutd) should be running if you start the dsmautomig command manually. Otherwise, the dsmautomig command might not be able to complete the migration if it runs out of candidates from the candidates list.

The dsmautomig command must be found with the PATH variable, or the dsmmonitord daemon cannot complete threshold migration.

Parameters

filesystemspec

Specifies the name of the file system for which you want to run threshold migration. The default is all file systems for which space management is active. You can specify more than one file system name, and you can use wildcard characters within a file system name. If you specify more than one file system name, separate each name with one or more blank spaces.

storage_pool_name::absolute_filesystem_path

Specifies the storage pools that are in the absolute_filesystem_path path that are migrated automatically.

options

–Detail

Displays information about migrated files.

–ERRORLOGName=file_path

Specifies the path and file name of the error log file to be used by this command. Output from only this command is logged to the specified file. Other commands and daemons write output to the error log file specified by the errorlogname option in options file dsm.sys or dsm.opt, or as specified by the DSM_LOG environment variable. If any part of the path you specify does not exist, the Tivoli Storage Manager for Space Management client creates it.

–Help

Displays syntax and options for the command. Do not specify other options when you specify the help option.