HSM client command reference
You can use commands to do all HSM tasks. You must use the correct syntax and format when you enter commands.
When you issue commands and options, follow these rules:
- Do not precede HSM commands with dsmc. Each space management client command is a separately executable command.
- Enter the complete command name in lowercase letters. You cannot use uppercase letters or an abbreviation for a command name.
- Do not stop any HSM process with the command kill -9.
- Use the following wildcard characters in file, directory, or file
system specifications. The shell in which you are running matches
and expands wildcard characters.
- *
- Matches zero or more characters
- ?
- Matches any single character
- Enter the characters in a command in a continuous string without pressing the Return key. You can enter as many as 256 characters on the command line.
- Standard option formats
You can specify options on some commands. You must use a standard format to specify all options. - Help for commands
Use the help option to display help for each command-line command or use the dsmmighelp command. - Displaying file and file system information
There is a set of HSM commands you can use to display space management information about your file systems, files, and directories. - Client return codes
The space management client command-line interface exits with return codes that accurately reflect the success or failure of the operation. - HSM command summary
- dmkilld
The dmkilld command stops the master recall daemon and all of its children and interrupts all active recalls. - dsmattr
The dsmattr command sets or changes the recall mode for one or more migrated files. The recall mode determines how the space management client recalls a migrated file when you access it. - dsmautomig
The dsmautomig command starts parallel migration sessions to the Tivoli® Storage Manager server, migrating more than one file at a time. - dsmdf
The dsmdf command displays the information for one or more file systems, such as file system state, inode information, and space information. - dsmdu
The dsmdu command displays space usage information for files and directories. For migrated files, the dsmdu command uses the actual size of the files that are stored in Tivoli Storage Manager storage to calculate space usage. In contrast, the du command (provided with your operating system) uses the size of the stub files that are stored in your local file system. - dsmls
The dsmls command displays file information, such as sizes and state. - dsmmigfs add and update
Use the dsmmigfs command with the add parameter to add space management to the file system. Use the dsmmigfs command with the update parameter to update space management settings for your file system. - dsmmigfs addmultiserver, querymultiserver, and removemultiserver
Use the dsmmigfs command with the addmultiserver, querymultiserver, or removemultiserver parameter to manage space in an environment with multiple Tivoli Storage Manager servers. - dsmmigfs deactivate, reactivate, and remove
Use the dsmmigfs command with the deactivate, reactivate, or remove parameter to deactivate, reactivate, or remove space management from a file system. - dsmmigfs globaldeactivate and globalreactivate
Use the dsmmigfs command with the globaldeactivate or globalreactivate parameter to either deactivate or reactivate space management for a space-managed client node. - dsmmigfs help
Use the dsmmigfs command with the help parameter to display the dsmmigfs command syntax and options. - dsmmigfs query
Use the dsmmigfs command with the query parameter to display the current space management settings for a file system. - dsmmigfs rollback
Use the dsmmigfs command with the rollback parameter to transfer the space management of file systems to the preferred node if the node is different from the current owner node. - dsmmigfs enablefailover, and disablefailover
Use the dsmmigfs command with the enablefailover or disablefailover parameter to manage recovery from partial system failure. - dsmmigfs stop, start, and restart
use the dsmmigfs command with the stop, start, or restart parameter to control space management daemons. - dsmmigfs takeover
Use the dsmmigfs command with the takeover parameter to transfer the HSM management of a file system to another space management client node within the same local GPFS™ node set. - dsmmighelp
The dsmmighelp command displays online help topics from which you can select general help for commands or message information. - dsmmigquery
The dsmmigquery command displays information about migrated files, candidates, and management classes. - dsmmigrate
The dsmmigrate command selects specific files from the local file system and migrates them to the Tivoli Storage Manager server. - dsmmigundelete
The dsmmigundelete command recreates deleted stub files for migrated files, and creates stub files for premigrated files for which an original file does not exist on your local file system. The file then becomes a migrated file. - dsmmonitord
The dsmmonitord command starts the HSM space monitor daemon if it has stopped. If you issue this command and the space monitor daemon is running, action is not taken. - dsmq
The dsmq command displays following information about each recall process that is queued for processing. - dsmrecall
The dsmrecall command selectively recalls migrated files or parts of migrated files to the local file system. Space management must be active. - dsmrecalld
The dsmrecalld command starts a recall daemon if it is not running. - dsmreconcile
The dsmreconcile command synchronizes the file systems on your client node with the Tivoli Storage Manager server that you contact for space management services. Use this command at any time to reconcile one or more file systems. Specify how often to automatically reconcile with the reconcileinterval option and how long to keep obsolete copies with the migfileexpiration option in the dsm.sys file. - dsmrm
The dsmrm command removes a recall process from the queue. To obtain the required recall ID to remove a recall process, use the dsmq command. - dsmscoutd
The dsmscoutd command starts, stops, and restarts the scout daemon. You can also use the command to start a scan, show future scan times, and show past scan information for file systems. - dsmsetpw
The dsmsetpw command changes the Tivoli Storage Manager password for your client node. - dsmwatchd
The dsmwatchd command starts the watch daemon.
Related concepts: