mkfcmap

You can use the mkfcmap command to create a new FlashCopy mapping, which maps a source virtual disk to a target virtual disk ready for subsequent copying.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- mkfcmap -- ----------------------------------->

>-- -source --+- src_vdisk_id ---+-- --------------------------->
              '- src_vdisk_name -'

>-- -target --+- target_vdisk_id ---+-- ------------------------>
              '- target_vdisk_name -'

>--+-------------------------+-- ------------------------------->
   '- -name -- new_name_arg -'

>--+-----------------------------------------+-- --------------->
   '- -consistgrp --+- consist_group_id ---+-'
                    '- consist_group_name -'

>--+--------------+--------------------------------------------><
   '- -copy_rate -'

Parameters

-source src_vdisk_id | src_vdisk_name
Specifies the ID or name of the source virtual disk.
-target target_vdisk_id | target_vdisk_name
Specifies the ID or name of the destination virtual disk.
-name new_name_arg
Optionally specifies a name to assign to the new mapping.
-consistgrp consist_group_id | consist_group_name
Optionally specifies a consistency group to add the new mapping to. If you do not specify a consistency group, the mapping is assigned to the default Consistency Group 0.
-copy_rate
Optionally specifies the priority of the background copy rate. The -copy_rate flag specifies the background copy rate. If 0 is displayed, it means that it is in idle state.

Description

This command creates a new FlashCopy mapping logical object. This mapping persists until it is deleted. The mapping specifies the source and destination virtual disks. The destination must be identical in size to the source, or the mapping will fail. Issue the svcinfo lsvdisk -bytes command to find the exact size of the source Vdisk that you want to create a target disk of the same size. The source and destination cannot be in an existing mapping. That is, a virtual disk can be either a source or a destination disk in only one mapping. A mapping is triggered at the point in time when the copy is required.

The mapping can optionally be given a name and assigned to a consistency group. These are groups of mappings that can be triggered at the same time. This enables multiple virtual disks to be copied at the same time, which creates a consistent copy of multiple disks. This is required by some database products in which the database and log files reside on different disks.

If no consistency group is defined, the mapping is assigned into the default group 0. This is a special group that cannot be started as a whole. Mappings in this group can only be started on an individual basis.

The background copy rate specifies the priority that should be given to completing the copy. If 0 is specified, the copy will not proceed in the background. The default is 50.

Possible failures

Note:Note: If you receive an error for this command that indicates that the licensed virtualization capacity has been exceeded, then the command was still effective. However, the return code will indicate the license violation.

Examples

An invocation example

svctask mkfcmap -source 0 -target 2 -name mapone

The resulting output

FlashCopy mapping, id [1], successfully created

(C) Copyright International Business Machines Corporation 2003, 2004