setrolepaircg
Use the setrolepaircg command to assign a specific user defined consistency group name to a role pair. The name provided will be used when the consistency group name is created on the storage system. This command is not supported for all role pairs.
Syntax
Parameters
- -help | -h | -?
- Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
- -quiet
- Suppresses the confirmation prompt for this command. This flag answers yes to all confirmation prompts.
- -clearcgname
- Clears the user defined consistency group name for the specified role pair. This will cause the session to internally select a consistency group name for the role pair.
- -cgname cg_name
- Specifies the user defined consistency group name that will be set for the specified role pair. When a user defined consistency group name is set for a role pair, the session will use the specified value instead of internally selecting one.
- -rolepair role_pair_name
- Specifies the role pair for which the consistency group name will be set. Role pair names are defined by the lsrolepairs command. Note: Not all role pairs allow a user defined consistency group name. If a role pair is specified that does not allow a user defined consistency group name, no updates will be made and an error message will be returned.
- session_name | -
- Specifies the session name for which you display the role pairs.
Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin). The dash is supported only in single-shot mode.
Example: Setting a consistency group name
The following command sets a consistency group name for the H1-J2 role pair in session GMsession.
csmcli> setrolepaircg -cgname 1F -rolepair H1-J2 GMsession
Are you sure you want to set a user defined consistency group name for session
GMsession, role pair H1-J2? [y/n]:y
IWNR1276I The consistency group name was successfully updated for session
GMsession, role pair H1-J2.Example: Clearing a consistency group name
The following command clears the consistency group name from the H1-J2 role pair in session GMsession.
csmcli> setrolepaircg -clearcgname -rolepair H1-J2 GMsession
Are you sure you want to clear the user defined consistency group name for session
GMsession, role pair H1-J2? [y/n]:y
IWNR1276I The consistency group name was successfully updated for session
GMsession, role pair H1-J2.