dsmclc delete

Edit online

The dsmclc.exe command with the delete parameter deletes migrated files from IBM® Storage Protect storage.

Syntax


1  DSMCLC.exe DELETE -g filespace search_pattern ? connection_options?  -l loglevel

Parameters

-g filespace
Specify a file space on IBM Storage Protect storage. The file space name is case sensitive.
search_pattern
Specify a pattern for migrated objects. All migrated objects that match the pattern are included in the operation. There are several parts to a search pattern. Some parts are required; some parts are optional. Separate the parts with a blank space. Search pattern elements are case-sensitive. If there is no hardware mapping, you can use wildcard characters asterisk (*) and question mark (?).
volume_pattern
Specify a pattern that matches volume names. The volume pattern is required. If the volume pattern contains blank spaces, enclose the pattern with quotation marks.

If there is a hardware mapping for the volume, you must specify the file-server host name and drive letter without wildcard characters.

directory_pattern
Specify a pattern that matches directory names. The directory pattern is required. If the directory pattern contains blank spaces, enclose the pattern with quotation marks.
file_pattern
Specify a pattern that matches file names. The file pattern is optional. If the volume pattern contains blank spaces, enclose the pattern with quotation marks.
-version number
Specify a file version.

The version parameter is optional. If you do not specify a version, all versions are deleted.

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.
-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
Delete the migrated objects in the c:\projects\2005\ directory. The migrated objects are in file space def-hsm01.

Command: dsmclc delete -g def-hsm00 c: \projects\2005

Task
Delete all migrated *.doc files in the \projects\2011\ directory of a remote IBM Storage Protect server. The remote IBM Storage Protect is identified by connection shortcut r2. The migrated files are in file space def-hsm01.

Command: dsmclc delete -c r2 -g def-hsm01 \\remote_file_server\G$ \projects\2011\ *.doc

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