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
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)
- 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