chrcrelationship

This command enables you to modify certain attributes of an existing relationship. This command enables you to add a relationship to a consistency group or to remove a relationship from a consistency group, as well as change the name of the relationship.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- chrcrelationship -- -------------------------->

>--+-------------------------+-- ------------------------------->
   '- -name -- new_name_arg -'

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

>--+----------+-- --+- rc_rel_name -+--------------------------><
   '- -force -'     '- rc_rel_id ---'

Parameters

-name new_name_arg
Optionally specifies a new label to assign to the relationship
-consistgrp consist_group_id | consist_group_name
Optionally specifies a new consistency group to assign the relationship to.
-force
Optionally specifies the force flag which will remove the relationship from a consistency group making the relationship a standalone relationship.
rc_rel_name | rc_rel_id
Specifies the ID or name of the relationship.
Note:Note: The -name, -consistgrp and -force are mutually exclusive parameters. That is, only one of these parameters can be specified per command line.

Description

This command can modify the specified attributes of the relationship supplied. Only one attribute can be modified at a time. That is, all four optional flags are mutually exclusive. In addition to changing the name of a consistency group, this command can be used for the following purposes.

Possible failures

Examples

An invocation example

Change the name of the relationship rccopy1 to testrel

svctask chrcrelationship -name testrel rccopy1

Add relationship rccopy2 to group called newgroup.

svctask chrcrelationship -consistgrp newgroup rccopy2

Remove relationship rccopy3 from whichever consistency group it is a member of.

svctask chrcrelationship -force rccopy3
The resulting output
No feedback

There is no feedback in any of these cases.

(C) Copyright International Business Machines Corporation 2003, 2004