prestartfcmap

The prestartfcmap command prepares a FlashCopy® mapping so that it can be started. This command flushes the cache of any data that is destined for the source VDisk and forces the cache into the write-through mode until the mapping is started.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svctask -- -- prestartfcmap -- --+------------+-- ---------->
                                     '- -restore -'      

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

Parameters

-restore
(Optional) Specifies the restore flag. This forces the mapping to be prepared even if the target VDisk is being used as a source VDisk in another active mapping. An active mapping is in the copying, suspended, or stopping state.
fc_map_id | fc_map_name
(Required) Specifies the name or ID of the mapping to prepare.

Description

This command prepares a single mapping for subsequent starting. The preparation step ensures that any data that resides in the cache for the source VDisk is first transferred to disk. This step ensures that the copy that is made is consistent with what the operating system expects on the disk.

The restore parameter can be used to force the mapping to be prepared even if the target VDisk is being used as a source VDisk of another active mapping. In this case, the mapping is restoring as shown in the svcinfo lsfcmap view. If the restore parameter is specified when preparing a mapping where the target VDisk is not the source VDisk of another active mapping, then the parameter is ignored.

Note: To prepare a FlashCopy mapping that is part of a consistency group, you must use the prestartfcconsistgrp command.

The mapping must be in the idle_or_copied or stopped state before it can be prepared. When the prestartfcmap command is processed, the mapping enters the preparing state. After the preparation is complete, it changes to the prepared state. At this point, the mapping is ready to start.

Attention: This command can take a considerable amount of time to complete.

An invocation example

svctask prestartfcmap 1

The resulting output

No feedback
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.