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 IBM Storage® Protect 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.
This command is valid only on GPFS™ file systems.
The dsmdf and dsmdu commands can display incorrect resident file size when you migrate newly-created files. This is because IBM® Storage Scale is not synchronized on all nodes when you migrate files. The last block of a file is not released from the disk although the file migrated successfully. This can cause deviation from assumed disk usage if many small files are migrated and blocksize is high.
| Cluster A | Cluster B |
|---|---|
| A space management client is installed | A space management client is installed |
| File system A | File system A (from Cluster A remotely mounted on Cluster B) |
| Mounted locally | Mounted remotely |
| Space-managed by A | Not Space-managed by B |
Only file systems of the local cluster can be managed by HSM. The local Cluster A file system is space-managed by Cluster A, but cannot be space-managed by Cluster B, although it is remotely mounted on Cluster B. The Data Management Application Programming Interface (DMAPI) interface does not work for remotely mounted file systems, so incorrect values might be reported by dsmls or dsmdu.
Syntax
Parameters
- options
- If you do not specify either of the following options, the space management client displays the
number of 1 KB blocks that the specified directory and each of its
subdirectories use.
- –Allfiles
- Displays the number of 1 KB blocks that each file in the specified directory and each of its subdirectories use.
- –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.
- –Summary
- Displays only the total of 1 KB blocks that the specified directory and its subdirectories use.
- directoryspec
- The directory for which you want to display information. The default is the current directory and its subdirectories. Use wildcard characters to specify more than one directory. You can issue more than one directory specification in one command. If you issue several directory specifications, separate each name with one or more blank spaces.
Examples
| Task | Command |
|---|---|
| Display space usage information for the current directory and all of its subdirectories. | dsmdu |
Display space usage information for the /migfs3/test directory
and all of its subdirectories. |
dsmdu /migfs3/test |
Display space usage information for each file
in the /migfs2/test directory and in all of its subdirectories. |
dsmdu -a /migfs2/test |
Display the total number of 1 KB blocks that
the /migfs2/test directory and all of it subdirectories
use. |
dsmdu -Summary /migfs2/test |