chfcmap

You can use the chfcmap command to modify certain attributes of an existing mapping.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- chfcmap -- --+-------------------------+-- --->
                               '- -name -- new_name_arg -'

>--+-----------------------------------------+-- --------------->
   '- -consistgrp --+- consist_group_id ---+-'
                    '- consist_group_name -'

>--+--------------+-- --+----------+-- --+- fc_map_id ---+-----><
   '- -copy_rate -'     '- -force -'     '- fc_map_name -'

Parameters

-name new_name_arg
Optionally specifies a new name to assign to the mapping. The -name argument is mutually exclusive with the other flags.
-consistgrp consist_group_id | consist_group_name
Optionally specifies the consistency group for which you want to modify the mapping.

The -consistgrp and -copyrate arguments are not mutually exclusive with each other: that is, you can specify both arguments in one command-line invocation. The consistency group cannot be modified while a copy is active or while the target consistency group is active. This parameter is mutually exclusive with the -name and -force parameters.

-copy_rate
Optionally specifies the priority of the background copy rate. The -consistgrp and -copyrate arguments are not mutually exclusive with each other: that is, you can specify both arguments in one command-line invocation. This parameter is mutually exclusive with the -name and -force parameters.
-force
If no consistency group ID is specified and the optional force flag is used, the mapping will be modified to a standalone mapping (equivalent to creating the mapping without a consistency group ID). This parameter is mutually exclusive with all other parameters.
fc_map_id | fc_map_name
Specifies the ID or name of the mapping to modify.

Description

This command modifies the specified attributes of an existing mapping. When modifying the name of a mapping, you cannot modify any of the other attributes at the same time. You can only modify the consistency group that the mapping belongs to if the mapping is inactive. A mapping is inactive if it has not been triggered or if it has been triggered, but the copy has run to completion.

If you have created several FlashCopy mappings for a group of VDisks that contain elements of data for the same application, you may find it convenient to assign these mappings to a single FlashCopy Consistency Group. Then you can issue a single prepare or trigger command for the whole group, so that, for example, all the files for a particular database are copied at the same time.

Possible failures

Examples

An invocation example

svctask chfcmap -name testmap 1