mkgrp

Use the mkgrp command to create a Replication Manager group of volumes that can be used as target copy relationships.

Syntax

Read syntax diagramSkip visual syntax diagram>>-repcli-- --mkgrp-- ---vol--volume-- [...]-- ----------------->

>--+----------------------+-- --group_name---------------------><
   '--desc--"description"-'

Parameters

-vol volume [...]
Specifies the volumes to be included in the group membership for the session. All volumes must be of the same device type. The same volume may reside in multiple groups.

Valid volume values include the following types:

  • 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
-desc "description"
An optional parameter that assigns a user-defined description of the Replication Manager group. The maximum alphanumeric character length for this value is 250.
group_name
Assigns a user-defined group name for the volumes. The group name must be unique; it cannot be the same as another existing Replication Manager group name. The maximum alphanumeric character length for this value is 250.

Description

You can use the mkgrp command to create a Replication Manager group of volumes that can be used as target copy relationships.

Return values

return value
Group group_name successfully created.

Possible failures

Examples

An invocation example

repcli mkgrp -vol ESS:2105.65312:VOL:202A,2C,2E-30  group1

The resulting output

Group group1 successfully created. 

Related topics

(C) Copyright International Business Machines Corporation 2004