Managing scans for volume statistics

You can use the dsmhsmclc.exe command to manage scans for volume statistics. You can configure scans, set schedules for scans, deactivate scans, and query the configuration.

Syntax

Read syntax diagramSkip visual syntax diagramDSMHSMCLC.exeCONFIGUREScanvolume_mount_pathconfig_optionsUNCONFIGUREScanvolume_mount_pathQuery,volume_mount_pathHelp?-lloglevel

Options

CONFIGUREScan
Use this option to configure a scan for volume statistics for the specified volume mount path.
UNCONFIGUREScan
Use this option to remove the scan for volume statistics from the specified volume mount path.
Query
Use this option to query the threshold migration configuration and reconciliation configuration of one or more volumes. Separate volume mount paths with a comma and no blank space. The default is all configured volumes.

In addition to configuration values, the query can display the following information for each volume, depending on whether threshold migration, reconciliation, scan for volume statistics, or all three, are configured:

  • Time of next process
  • Space usage
  • Running processes:
    • Reconcile
    • Threshold migration (TM)
    • Scan for TM candidates
    • Validation of TM candidates
    • Scan for volume statistics
volume_mount_path
Specify the volume mount path. Because it is possible for a single volume to be mounted by more than one path, always specify a volume by the same mount path. Reconciliation, threshold migration, migration jobs, and volume scan jobs must all reference the volume by the same path.
config_options

You can specify any of the following configuration options. Specify each option no more than once. If the volume is not configured, omitting the option from the command configures the volume with the default value for the option. If the volume is configured, omitting the option from the command leaves that configuration value unchanged.

-NEXTScan YYYY-MM-DD-hh-mm

Use this option to configure when the next regular scan for volume statistics occurs. The date and time indicate year (YYYY), month (MM), day (DD), hour (hh), and minute (mm). Separate each element with a dash (-). The default is the current date and time.

-SCANinterval hours

Use this option to configure how frequently the HSM monitor service starts the scan for volume statistics. The time is measured in hours from the end of the last scan to the beginning of the next scan. You can specify a value in the range 1 - 9999. The default is 720.

-SCANNOW yes|no

Use this option to configure an immediate scan for volume statistics. The default is no.

-L loglevel

Specify the type of information that is to be recorded in logs and trace files. You can specify one or more values with no commas or blank space separators. Severe and error messages are always recorded. The default combination is severe, error, warning, information, and library (SEWIL). The following values are valid:

  • C (event)
  • D (debug)
  • E (error)
  • F (flush)
  • I (information)
  • K (driver)
  • L (library)
  • S (severe)
  • T (trace)
  • U (user)
  • W (warning)
  • X (dump)
Help
Use this option to display help for the command. Entering the command with no options also displays help for the command.
?
Use this option to display help for the command. Entering the command with no options also displays help for the command.

Example

Task
Configure volume T:\ to scan for volume statistics. Schedule a scan for once a week on Sundays at 6 am.

Command: dsmhsmclc configurescan t: -nextscan 2019-08-18-06-00 -scaninterval 168

The scan results are written to the scan log file hsmmonitor-volumes-stats.log.

Output
VNAME="T:\" VSIZE="10734268416" VFREE="9105620992" VUSED="1628647424" VUSAGE="15.172412" NFILES="240" NSTUBS="5" 
FSIZEALL="1577975038" SSIZELOC="0" SSIZEFUL="8679424" SCANTYPE="scan" SCANSTART="20190815-044636" SCANEND="20190815-044702"
  • where:
    • VNAME="T:\" volume name
    • VSIZE="10734268416" volume size (bytes)
    • VFREE="9105620992" amount of free space on the volume (bytes)
    • VUSED="1628647424" amount of used space on the volume (bytes)
    • VUSAGE="15.172412" percentage of volume space that is used
    • NFILES="240" number of files (stubs and resident)
    • NSTUBS="5" number of stubs
    • FSIZEALL="1577975038" total size of all files in the volume (bytes)
    • SSIZELOC="0" total size of local stubs (bytes)
    • SSIZEFUL="8679424" logical size of stubs (bytes)
    • SCANTYPE="scan" scan type
    • SCANSTART="20190815-044636" scan start date and time
    • SCANEND="20190815-044702" scan end date and time