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.
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.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 which 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. If a remote copy relationship associated with the target was mirroring I/O when the map was copying, it might lose its difference recording capability and require a full resychronization on a subsequent restart.
- -split
- (Optional) Breaks the dependency on the source volume 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 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 (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.
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 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
stopfcmap testmapone
The resulting output
No feedback