dsmclc migrate

Edit online

The dsmclc.exe command with the migrate parameter starts a migration job. You can omit the migrate parameter, but you must specify the job file name.

Syntax


1  DSMCLC.exe? MIGRATE jobfile?  -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

jobfile
Specify a migration job file. You can specify a complete path, or only file name and file type, or only the file name. For example, the following commands specify the same job file:
  • dsmclc c:\hsmclient\jobs\migrate011.osj
  • dsmclc migrate011.osj
  • dsmclc migrate011
-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 option but do not specify yes or no, a yes value is assumed.
-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 with the job that is defined in c:\hsmclient\jobs\migrate011.osj.

Command: dsmclc c:\hsmclient\jobs\migrate011.osj

Task
Migrate files with the job that is defined in c:\hsmclient\jobs\migrate011.osj. Use management class MC2. The backup-archive client determine the options file, even if you specified another options file when you configured this job.

Command: dsmclc -m MC2 c:\hsmclient\jobs\migrate011.osj -optfile

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