FlashCopy cloning function-clauses

Edit online

The following functions are supported by the fcmcli command option -f 'function' for FlashCopy® cloning operations: 


1 
2.1   -f create_clone?   -F
2.1   -f refresh_clone?   -F
2.1   -f preproc_clone
2.1   -f postproc_clone
2.1   -f inquire_clone
2.1   -f inquire_detail_clone
2.1   -f delete_clone?   -F
1   -C clone-database-name
1   -u clone-database-instance user name(1)
1   -X preprocessing-configuration-filename
1   -Y postprocessing-configuration-filename
Notes:
  • 1 This option is not required for -f inquire_clone or -f inquire_detail_clone commands.
Where:
-F
The force command option it optional. Depending on the cloning command, the following results are possible:
  • delete_clone: The force option causes the clone to be unmounted, marked as deleted, and also deletes the FlashCopy relationships. Otherwise, the delete_clone function unmounts the clone and marks it as deleted in the FlashCopy Manager repository.
  • create_clone, refresh_clone: The force option deletes all backup versions that are older than the clone targets that are reused for the new or refreshed clone. Otherwise, a failure can occur when there are backup versions older than the clone targets that are reused for the new or refreshed clone.

    This option is valid for Storwize® family and SAN Volume Controller Version 5.1, or later.

-C clone-database-name
The name of the cloned database on the clone system. This option must be specified for all cloning functions.

Specify a valid database name. The clone database name can be the name of the production database or you can specify an alternative name.

-u clone-database-instance user name
Specify the user name of the clone instance owner. This option is required when the following functions are issued:
  • create_clone
  • delete_clone
  • refresh_clone
  • preproc_clone
  • postproc_clone
-X preprocessing-configuration-filename
The name of the configuration file to be used with the preprocessing script. The preprocessing configuration file must be on the clone server.
-Y postprocessing-configuration-filename.
The name of the configuration file to be used with the postprocessing script. The postprocessing configuration file must be on the clone server.

The return code of the fcmcli command is 0 if it finishes the request without an error or if there were no candidates for the request. The return code is 1 if one or more minor issues occur which are not critical but must be checked to prevent major issues later. Return code 2 indicates that an error occurred during the command execution.

Issue cloning-related commands on the production system as the production database instance owner. The cloning commands must be issued from the instance directory where the IBM® Storage Protect Snapshot product files are located. The fcmcli command identifies the name of the production database.

  • For Oracle databases, the production database is identified by the value set for ORACLE_SID in the CLIENT section of the profile that is referenced with the -U option.