qoperation merge

Description

This command merges a captured database into a target CommCell. The database should reside on the CommServe and the user should supply the database name and the location.

This command also supports an option to read the answer file for the merge configuration. If the database file path is a UNC path, then the command line prompts the user to enter the impersonation details. You can specify whether or not to consume a license during this merge.

Upon successful completion, qoperation merge displays the message "Merge Successful" in the console.

In case of an error, an error code and description are displayed as: "merge: Error errorcode: errordescription"

Usage

qoperation merge -dfn <dumpfile> [-afn <answerfile>] [-u <username>] [-p <password>] [-cl <y|n>] [-rt <y|n>] [-rp <alternate database path>] [-tf <tokenfile>] [-tk <token>] [-af <argsfile>] [-h]

Options

-dfn	Path and Dump file name on the CommServe
-afn	Answer file name (with the path) on the client that was generated during capture
-u	User name, if database location is an UNC path
-p	Password, if database location is an UNC path
-cl	y or n - This option determines whether a licenses is consumed or not for the merged client.
-rt	y or n - This option determines whether or not to mark the media as reusable in the new CommCell. If the answer is set to 'Y', the media will be reused even if the library option to use media from a different CommCell is disabled. If the answer is set to 'N', you can later select the media for reuse at the destination CommCell using the Mark Migrated Media Reusable option.
-rp	Alternative database restore path. This option is useful when migrating clients in the clustered environment. In a cluster, the CommServe binaries are installed on the physical server and the database is located on the shared disk resource. As the capture and merge operations are executed on the physical server that hosts the binaries, the -rp option provides a way to specify the path to the shared disk resource in which the database resides. (If this option is not specified, the command will look for the database in the same drive in which the binaries reside by default, and the operation will fail.)
-af	Reads arguments from a file
-tf	Reads token from a file
-tk	Token string
-h	Displays help

Argument File

For information on creating an argument file, see Command Line - FAQ - How do I use argument files in commands.

dumpfilename	[string] Path and Dump file name on the CommServe
answerfile	[string] Answer file name (with the path) on the client that was generated during capture
consumelicense	[y\|n] This option determines whether a licenses is consumed or not for the merged client.
reusetapes	[y\|n] This option determines whether or not to mark the media as reusable in the new CommCell. If the answer is set to 'Y', the media will be reused even if the library option to use media from a different CommCell is disabled. If the answer is set to 'N', you can later select the media for reuse at the destination CommCell using the Mark Migrated Media Reusable option.
user	[string] User name
password	[string] Password

Diagnostics

Possible exit status values are:

0 - Successful completion.

1 - CLI usage failures, due to the use of an unsupported option or missing argument.

2 - Any other failure.

Example

In windows, merge using dump file c:\capturedump.dmp on the CommServe, and read the answer file at C:\test.xml on the local client.

qoperation merge -dfn c:\capturedump.dmp -afn c:\test.xml