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

Parameters

-force

(Optional) Specifies that all processing that is associated with the designated mapping is 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.

When you do not use the -force parameter, the command is rejected for a target volume of the FlashCopy mapping that is the primary in a relationship that is mirroring I/O:

consistent_synchronized
consistent_copying
inconsistent_copying

If the -force parameter is specified to a FlashCopy mapping whose target volume is also in a Metro Mirror or Global Mirror relationship, the relationship stops. A remote copy relationship associated with the target that is mirroring I/O while the map is copying might lose its difference recording capability. In this case, a full resynchronization might be necessary during a subsequent restart.

-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.

Note: Before IBM Spectrum Virtualize 4.2.0, the stopfcmap command always changed the mapping state to stopped and took the target volume 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 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.

Note: Maps that are rc_controlled are not shown in the view when this command is specified.

Remember: A source volume that is in an active-active relationship stops the FlashCopy mapping only when information on the source volume is current. Alternatively, you can stop the mapping after you provide an older accessible copy with the following command:

stoprcrelationship -access

A current volume in an active-active relationship is the primary copy, or the secondary copy when the relationship's state is consistent_syncronized.

An invocation example

stopfcmap testmapone

The resulting output

No feedback