startfcmap

You can use the startfcmap command to start (trigger) a FlashCopy mapping. This command makes a point-in-time copy of the source virtual disk at the moment the command is executed.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- startfcmap -- --+---------+-- ---------------->
                                  '- -prep -'

>--+- fc_map_id ---+-------------------------------------------><
   '- fc_map_name -'

Parameters

-prep
Optionally specifies to prepare the mapping or group prior to triggering the mapping.
fc_map_id | fc_map_name
Specifies the ID or name of the mapping to trigger. Triggering of mappings is usually performed on a consistency group basis. If the mappings have not been prepared, then this command will fail unless -prep is specified which causes a prepare to happen prior to the triggering. If the mapping belongs to Cconsistency Group 0, then the map_id | name must be specified.

Description

This command triggers a single mapping. Triggering means to take a point-in-time copy of the source virtual disks.

The mapping must first be prepared for triggering. See the svctask prestartfcmap command to prepare the triggering. However, you can run this command with the optional -prep argument, which prepares the mapping and triggers the copy as soon as the preparation is complete. This means it is under the systems control when the trigger happens. That is, the preparation step takes some time to complete before the copy is made. If you want to control the triggering, you should use the svctask prestartfcmap command first.

The mapping enters the copying state. The way the copy proceeds depends on the background copy rate attribute of the mapping. If the mapping is set to 0, only data that is subsequently updated on the source will be copied to the destination. This operation means that the destination can only be used as a backup copy while the mapping exist in the copying state. If the copy is stopped, the destination will not be usable. If you want to end up with a duplicate copy of the source at the destination, you should set the background copy rate greater than 0. This means that the system copies all the data (even unchanged data) to the destination and eventually reaches the idle or copied state. After this data is copied, you can delete the mapping and have a usable point-in-time copy of the source at the destination.

Triggering is usually performed on a consistency group basis. Only mappings belonging to Consistency Group 0 can be triggered on their own.

Possible failures

Examples

An invocation example

svctask startfcmap -prep 2