dsmclc listfilespaces

The dsmclc.exe command with the listfilespaces parameter lists files spaces on an IBM® Storage Protect server. The HSM for Windows™ client lists all file spaces that you are authorized to see. The command indicates the occupancy of the file space.

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.

Syntax


1  DSMCLC.exe LISTFILESPACES file_space_pattern  ? connection_options?  -l loglevel

Parameters

connection_options

If the operation involves a remote file server, you must specify an IBM Storage Protect connection.

You can specify a connection by specifying the two parts of a connection pair or by specifying a shortcut.

Specify the two parts of a connection
Use the h and u parameters:
h TSM_host_name
Specify the IBM Storage Protect server part of a connection pair. The value of TSM_host_name is not case-sensitive. Specify TSM_host_name with the value of the TCPSERVERADDRESS option and the value of the TCPPORT option, separated with a colon. For example: 127.0.0.1:1500
u node_name
Specify the IBM Storage Protect node part of a connection pair. Use the same value that you used to define the IBM Storage Protect server connection. If the connection to the IBM Storage Protect server was configured with the asnodename option, specify the value of the asnodename option. If the connection was configured without the asnodename option, specify the value of the nodename option. The value of node_name is not case-sensitive.
Specify a connection shortcut
Instead of specifying the host name and node name parts of a connection, you can specify a connection shortcut. Use the c parameter to specify a connection shortcut:
c shortcut
The shortcut value is one or two characters and is generated by the HSM for Windows client. Connection shortcuts include these examples:
  • l (local)
  • r1 (remote connection 1)
  • r2 (remote connection 2)
Tip: Run dsmclc help to display connection shortcuts.
file_space_pattern
Specify a pattern for file spaces. If there is a blank space in the pattern, surround the pattern with quotation marks. Search pattern elements are case-sensitive. You can use wildcard characters * and ?.
-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)

Examples

Task
List all file spaces that you are authorized to see.

Command: dsmclc listfilespaces

Task
Display help for the dsmclc.exe command.

Command: dsmclc help

Task
Change the information that is recorded in log and trace files to the default.

Command: dsmclc -l