dsmclc migratelist

Edit online

The dsmclc.exe command with the migratelist parameter migrates files that are listed in a list file.

Syntax


1  DSMCLC.exe MIGRATELIST list_file -g filespace  -x
2.1 replace
2.1 keep
2.1 delete?  -b
2.1! ? yes?  -OPTFILE? file
2.1 no?  -d
2.1! yes
2.1 no?  -m mgmt_class?  -s
2.1! yes
2.1 no?  -l loglevel?  -v

Parameters

list_file
Specify the path of a list file. The list file contains a list of files. Within the list, each file is on a separate line. Each file is identified by a complete path from the root. For example, c:\projects\2009\budget1.xls. The list file is not created by the HSM for Windows™ client GUI. The list can be encoded in ASCII or Unicode. If Unicode, the first 2 bytes must be the byte order mark (BOM).
-g filespace
Specify a file space on IBM® Storage Protect storage. The file space name is case sensitive.
-x
Specify an action on the file system after the file is migrated to IBM Storage Protect storage:
REPLACE
Replace the migrated file with a stub file.
KEEP
Keep the complete file on the file system.
DELETE
Delete the file from the file system.
-b yes|no
Specify whether files are backed up before migration. The default is the value that you set in the initial configuration wizard. If you use the option but do not specify yes or no, files are backed up before migration.
-d yes|no
Specify whether Windows alternate data stream (ADS) data is migrated when the file is migrated. The default is the value that you set in the initial configuration wizard. A yes value means that ADS data is migrated when the file is migrated. A no value means that ADS data is not migrated. If you use the option but do not specify yes or no, a yes value is assumed.
-OPTFILE file
Specify the path of an options file for backup before migration.

This option is valid only if you also specify backup before migration.

If file is not specified, the backup-archive client uses its default options file. This file value overrides the value that is configured in a migration job file.

-m mgmt_class
Specify a management class for the migration job or list migration. This value overrides the management class that is specified when the job was created. Specify DEFAULT to use the IBM Storage Protect server default management class of the active policy set.
-s yes|no
Specify whether file security attributes (ACL) are migrated when the file is migrated. The default is the value that you set in the initial configuration wizard. A yes value means that the ACL is migrated when the file is migrated. A no value means that the ACL is not migrated. If you use the -s option but do not specify yes or no, the ACL is migrated when the file is migrated.
-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)
-v
Display verbose output.

Examples

Task
Migrate files in the list file c:\hsmclient\jobs\xlsfiles.txt to file space def-hsm01. Replace the migrated files with stubs. Back up files before migrating. Use options file d:\backupAdmin\optionsFiles\backup_options_set3.opt.

Command: dsmclc migratelist -g def-hsm01 -x replace c:\hsmclient\jobs\xlsfiles.txt -b -optfile d:\backupAdmin\optionsFiles\backup_options_set3.opt

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