chgrp

Use the chgrp command to change the description or the volume membership of an existing Replication Manager group.

Syntax

Read syntax diagramSkip visual syntax diagram>>-repcli-- --chgrp-- --+--------------------------+-- --------->
                        '--desc--"new_description"-'

>--+-------------------------+-- --+------------------------+--->
   '--addvol--volume-- [...]-'     '--rmvol--volume-- [...]-'

>-- --+--------+-- --group_name--------------------------------><
      '--quiet-'

Parameters

-desc "new_description"
An optional parameter that specifies the new user-defined description of the group. The maximum alphanumeric character length for this value is 250.
-addvol volume [...]
An optional parameter that specifies new volumes that you want to add to the group specified. All volumes must be of the same device type, but can belong to multiple groups. Valid volume values include those in the following list:
  • Device type
  • Component type
  • Device ID
  • Subsystem ID
  • Logical subsystem ID
  • Volume ID

What parameter values to specify: How to code the parameter:
To specify more than one volume value:
ESS:ELEMENTTYPE.SSID:VOL:LSSVOLNUM
To specify a single volume:
-vol ESS:2105.65312:VOL:202A
To specify the logical subsystem so that all of the volumes in the specified logical subsystem will be included:

You can choose volumes from any number of LSSs in an ESS.

Note:Note: The same volume can reside in multiple groups.
-vol ESS:2105.65312:VOL:20
To specify multiple volumes on different ESSs:
-vol ESS:2105.65312:VOL:202A,2C,2F
To specify a range of volumes for group membership, use a hyphen instead of a comma between volumes:
-vol ESS:2105.65312:VOL:202A-2F
To specify single volumes and a range of volumes in the same logical subsystem, you can alternate between commas and hyphens, for example:
-vol ESS:2105.65312:VOL:202A,2C,2E-30
-rmvol volume [...]
An optional parameter that specifies volumes that you want to remove from the group specified. All volumes must be of the same device type, but can belong to multiple groups. Valid volume values include those in the following list:
  • Device type
  • Component type
  • Device ID
  • Subsystem ID
  • Logical subsystem ID
  • Volume ID

What parameter values to specify: How to code the parameter:
To specify more than one volume value:
ESS:ELEMENTTYPE.SSID:VOL:LSSVOLNUM
To specify a single volume:
-vol ESS:2105.65312:VOL:202A
To specify the logical subsystem so that all of the volumes in the specified logical subsystem will be included:

You can choose volumes from any number of LSSs in an ESS.

Note:Note: The same volume can reside in multiple groups.
-vol ESS:2105.65312:VOL:20
To specify multiple volumes on different ESSs:
-vol ESS:2105.65312:VOL:202A,2C,2F
To specify a range of volumes for group membership, use a hyphen instead of a comma between volumes:
-vol ESS:2105.65312:VOL:202A-2F
To specify single volumes and a range of volumes in the same logical subsystem, you can alternate between commas and hyphens, for example:
-vol ESS:2105.65312:VOL:202A,2C,2E-30
-quiet
An optional parameter that turns off the confirmation prompt for this command.
group_name
Specifies the existing name of the group to be changed.

Description

You can use the chgrp command to change the description or the volume membership of an existing Replication Manager group.

Return values

Possible failures

Examples

An invocation example:

repcli chgrp -addvol ESS:2105.65312:VOL:202A-2F group1

The resulting output:

Group group1 successdfully modified.

Related topics

(C) Copyright International Business Machines Corporation 2004