stopfcmap

The stopfcmap command stops all processing that is associated with a FlashCopy® mapping that is in one of the following processing states: prepared, copying, stopping, or suspended.

Syntax


>>- svctask -- -- stopfcmap -- --+---------+-- ----------------->
                                 +- -force +      
                                 '- split-'      

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

Parameters

-force: (Optional) Specifies that all processing that is associated with the designated mapping be stopped immediately.
Note: When you use this parameter, all FlashCopy mappings that depend on this mapping (as listed by the lsfcmapdependentmaps command) are also stopped.
-split: (Optional) Breaks the dependency on the source VDisk of any mappings that are also dependent on the target disk. This parameter can only be specified when stopping a map that has progress of 100 as shown by the svcinfo lsfcmap command.
fc_map_id | fc_map_name: (Required) Specifies the name or ID of the mapping to stop.

Description

This command stops a single mapping. If the copy process is stopped, the target disk becomes unusable unless it already contained a complete image of the source (that is, unless the map had a progress of 100 as shown by the lsfcmap command). Before you can use the target disk, the mapping must once again be prepared and then reprocessed (unless the target disk already contained a complete image).

Only stand-alone mappings can be stopped using the stopfcmap command. Mappings that belong to a consistency group must be stopped using the stopfcconsistgrp command.

If the mapping is in the idle_or_copied state, the stopfcmap command has no effect and the mapping stays in the idle_or_copied state.

Note: Before SAN Volume Controller 4.2.0, the stopfcmap command always changed the mapping state to stopped and took the target VDisk offline. This change can break scripts that depend on the previous behavior.

The split option can be used when the mapping has progress of 100. It removes the dependency of any other mappings on the source VDisk. It might be used prior to starting another FlashCopy mapping whose target disk is the source disk of the mapping being stopped. Once the mapping has been stopped with the split option, the other mapping could then be started without the restore option.

An invocation example

svctask stopfcmap testmapone

The resulting output

No feedback