dsmtool.exe

Edit online

Run the dsmtool.exe command to display the quantity, size, and expiration period of migrated objects in IBM® Storage Protect storage.

You can display the occupancy data of migrated files in the following ways:

Use the IBM Storage Protect administrative command query occupancy.
The HSM for Windows™ client command dsmclc listfilespaces
The HSM for Windows client command dsmtool occupancy

The administrative command query occupancy determines the amount of storage that a client is using on the IBM Storage Protect server. The command displays the space that is used in an IBM Storage Protect storage pool. The query can be refined by specifying a node name, file space name and type of data. You must have administrative access to the IBM Storage Protect server to use this command.

The occupancy data that is displayed by the command dsmclc listfilespaces is the sum of file sizes of all migrated files for a file space. Occupancy also includes information for managing the migrated files. Compression, data deduplication, and expirations on the IBM Storage Protect server are not reflected in the statistics from the dsmclc listfilespaces command. The occupancy data is refreshed when you run the dsmtool command with the occupancy or statistic parameters.

For details on expirations due to copy group settings, see Technote 1330160.

The dsmtool occupancy command displays the size that the migrated objects occupy on the file system. Compressed size and expired objects are not included in the occupancy calculation. Only uncompressed, unexpired objects sizes are calculated.

Syntax

Parameters

OCCUPANCY: Specify the occupancy option to display the number of migrated files and their total size. The size is calculated as the size of the resident file on the file system.
The size can be different from the administrative command query occupancy.
STATISTIC: Specify the statistic option to display the number of migrated files and their total size, and the versions and expiration periods of unexpired migrated files. The statistic option also displays the number and size of migrated files that are marked for deletion at the next reconciliation.
file_space_pattern: You can specify a file space. The specification can contain the wildcard character (*). If you do not specify a file space, the command displays information for all file spaces.

Example

Task: Display occupancy of all file spaces for the HSM for Windows client node.
Command: dsmtool occupancy
Task: Display the versions and expiration periods of migrated files on all file spaces that begin with hsm.
Command: dsmtool statistic hsm*