dsmmigquery
The dsmmigquery command displays information about migrated files, candidates, and management classes.
You must have root user authority to use this command.
The dsmmigquery command displays the following information for one or more file systems:
- Migration candidates list
- Ordered recall list for migrated files
- Available management classes
- Current® client and server options
- List of all files in the file system
Output from this command is directed to stdout. Use redirection characters and a file name at the end of the command to redirect the output to a file.
Syntax
Parameters
- options
- –Detail
- Use with the mgmtclass option to display information about each available management class. If you do not use this option, the HSM client displays the management class name and a brief description only.
- –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 space management client creates it.
- –Help
- Displays syntax and options for the command. Do not specify other options when you specify the help option.
- –Mgmtclass
- Displays information about each management class that you can assign to your files.
- –Options
- Displays the current settings for your client and server options. This option is the default.
- –SErver=server_name
- Specify the target server for the task. This option is valid only
in a multiple-server environment. In a multiple-server environment
you must specify the server option.
This option is valid with the sortedall and sortedmigrated options.
- –SORTEDAll
- Lists all files in the file system in this order: resident files, premigrated files, migrated files. Sorts migrated files in the most efficient order for recall.
- –SORTEDMigrated
- Lists all files that you migrated from the file system to IBM Storage® Protect storage in the most efficient order for recall.
- filesystemspec
- The file system for which you want to display information. The default is the current file system. 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.
Examples
| Task | Command |
|---|---|
| Display the current settings for the client and server options. | dsmmigquery |
| Display information about management classes that you can assign to files on your client node. | dsmmigquery -Mgmtclass -Detail |