prestartfcconsistgrp

Use the prestartfcconsistgrp command to prepare a consistency group (a group of FlashCopy® mappings) so that the consistency group can be started. This command flushes the cache of any data that is destined for the source volume and forces the cache into the write-through mode until the consistency group is started.

Syntax

 prestartfcconsistgrp    [  -restore  ]   {  fc_consist_group_id  |  fc_consist_group_name  }

Parameters

-restore
(Optional) Specifies the restore flag. This forces the consistency group to be prepared even if the target volume of one of the mappings in the consistency group is being used as a source volume of another active mapping. An active mapping is in the copying, suspended, or stopping state.
fc_consist_group_id | fc_consist_group_name
(Required) Specifies the name or ID of the consistency group that you want to prepare.

Description

This command prepares a consistency group (a group of FlashCopy® mappings) to subsequently start. The preparation step ensures that any data that resides in the cache for the source volume is first flushed to disk. This step ensures that the FlashCopy® target volume is identical to what has been acknowledged to the host operating system as having been written successfully to the source volume.

You can use the restore parameter to force the consistency group to be prepared even if the target volume of one or more mappings in the consistency group is being used as a source volume of another active mapping. In this case the mapping restores as shown in the lsfcmap view. If the restore parameter is specified when preparing a consistency group where none of the target volumes are the source volume of another active mapping, then the parameter is ignored.

You must issue the prestartfcconsistgrp command to prepare the FlashCopy® consistency group before the copy process can be started. When you have assigned several mappings to a FlashCopy® consistency group, you must issue a single prepare command for the whole group to prepare all of the mappings at once.

The consistency group must be in the idle_or_copied or stopped state before it can be prepared. When you enter the prestartfcconsistgrp command, the group enters the preparing state. After the preparation is complete, the consistency group status changes to prepared. At this point, you can start the group.

If FlashCopy® mappings are assigned to a consistency group, the preparing and the subsequent starting of the mappings in the group must be performed on the consistency group rather than on an individual FlashCopy® mapping that is assigned to the group. Only stand-alone mappings, which are mappings that are not assigned to a consistency group, can be prepared and started on their own. A FlashCopy® consistency group must be prepared before it can be started.

This command is rejected if the target of a FlashCopy mapping in the consistency group is in a remote copy relationship, unless the relationship is one of the following types and is the secondary target of the remote copy:
  • idling
  • disconnected
  • consistent_stopped
  • inconsistent_stopped
The FlashCopy mapping also fails in the following cases:
  • You use the prep parameter.
  • The target volume is an active remote copy primary or secondary volume.
  • The FlashCopy target (and remote copy primary target) volume is offline. If this occurs, the FlashCopy mapping stops and the target volume remains offline.
Note: Maps that are rc_controlled are not shown in the view when this command is specified.

An invocation example

prestartfcconsistgrp 1

The resulting output:

No feedback