stopfcmap

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

Syntax

Read syntax diagramSkip visual syntax diagram stopfcmap  -force  -split fc_map_id_or_name

Parameters

-force
(Optional) Specifies that all processing that is associated with the designated mapping stops immediately.
Note: When you use this parameter, all FlashCopy mappings that depend on this mapping (as listed by the lsfcmapdependentmaps command) are also stopped.
If the -force parameter is not specified, the command is rejected if the target volume of the FlashCopy mapping is the primary in a relationship that is mirroring I/O:
  • consistent_synchronized
  • consistent_copying
  • inconsistent_copying
-split
(Optional) Breaks the dependency on the source volume of any mappings that are also dependent on the target disk. Specify this parameter only when you are stopping a map with a progress of 100 as shown by the lsfcmap command.
fc_map_id_or_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. A complete image is indicated by a map with a progress of 100, as shown by the lsfcmap command. For incomplete mappings, prepare and reprocess the mapping before you use the target disk.

Only stand-alone mappings can be stopped with the stopfcmap command. Stop mappings that belong to a consistency group with 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.

The split option can be used when the mapping has progress of 100. It removes the dependency of any other mappings on the source volume. It might be used before you start another FlashCopy mapping whose target disk is the source disk of the mapping that you are stopping. After the mapping stops by using the split option, you can start the other mapping without the restore option.

An invocation example

stopfcmap testmapone

The resulting output

No feedback