mkcpset

Use the mkcpset command to create copy sets.

Note: This command is not supported for IBM Spectrum® Virtualize Backup or Snapshot session types. Copy sets can be changed by adding or removing volumes from the volume group on the storage system.

When you run the mkcpset command for sessions other than IBM XIV® Storage System Snapshot, you can specify both the host volume and target volume for the copy set. For XIV Snapshot sessions, specify only the host volume for the copy set. The target volume for a Snapshot session is automatically created when the snapshot is created.

For IBM® DS8000®, IBM System Storage DS6000 and IBM TotalStorage Enterprise Storage Server® Model 800 storage systems, you must use the volume ID to specify a volume. For other storage systems, you can use the volume ID or a user-defined name as shown in the examples that are at the end of this topic. You specify the name for the volume by using the user interface for the storage system.

The types of volumes that you can specify for a copy set depend on the storage system and session type.

Tip: To display the status of volumes in a copy set, use the lsvol command.

Syntax

Read syntax diagramSkip visual syntax diagrammkcpset-help-h-?-quiet-h1 h1_volume_idh1_volume_name -h2h2_volume_idh2_volume_name-h3h3_volume_id-h4h4_volume_id-t1t1_volume_idt1_volume_name-j1j1_volume_id -j2j2_volume_id -j3j3_volume_id -r1r1_volume_id -i1i1_volume_id-i2i2_volume_idi2_volume_name-i3i3_volume_idsession_name - -c1c1_volume_idc1_volume_name-c2c2_volume_idc2_volume_name

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.
-h1 {h1_volume_id | h1_volume_name}
Specifies the host volume for the copy set at site 1.
This parameter is mutually exclusive with the -volumegroup parameter.
-h2 {h2_volume_id | h2_volume_name}
Specifies the host volume for the copy set at site 2.
-h3 h3_volume_id
Specifies the host volume for the copy set at site 3.
-h4 h4_volume_id
Specifies the host volume for the copy set at site 4.
-t1 {t1_volume_id | t1_volume_name}
Specifies the target volume for the copy set at site 1.
-j1 j1_volume_id
Specifies the journal volume for the copy set at site 1.
-j2 j2_volume_id
Specifies the journal volume for the copy set at site 2.
-j3 j3_volume_id
Specifies the journal volume for the copy set at site 3.
-i1 i1_volume_id
Specifies the intermediate volume for the copy set at site 1.
-i2 {i2_volume_id | i2_volume_name}
Specifies the intermediate volume for the copy set at site 2.
-i3 i3_volume_id
Specifies the intermediate volume for the copy set at site 3.
-c1 {c1_volume_id | c1_volume_name}
Specifies the change volume for the copy set at site 1.
-c2 {c2_volume_id | c2_volume_name}
Specifies the change volume for the copy set at site 2.
-r1 r1_volume_id
Specifies the recovery volume for the copy set at site 1.
This parameter is mutually exclusive with the -h1 parameter.
session_name | -
Specifies the name of the session that contains the copy sets.

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.

When you run Metro Global Mirror on the OMVS command line, the parameters for the mkcpset command can exceed the character limit that is set by the OMVS prompt. To overcome this limitation, create a script file that is called mgm_mkcpset.txt that contains the command that you want to issue. For example:
csmcli> mkcpset -h1 DS8000:2107.12345:VOL:0000 -h2 DS8000:2107.67890:VOL:0000 
-h3 DS8000:2107.02468:VOL:0000 -J3 DS8000:2107.01934:VOL:0000 myMGMSess
To run the script, you must ensure that you are in the CLI directory and have the appropriate paths exported. You then run the script from the command line by using the following sample code:
csmcli.sh -script mgm_mkcpset.txt

Example: Creating a copy set for an IBM DS8000 FlashCopy session by using the volume ID

The following command creates a copy set for a FlashCopy session that is named session1. The host volume at site 1 is DS8000:2107.04131:VOL:0A05 and the target volume is DS8000:2107.04131:VOL:0A06.

csmcli> mkcpset -h1 DS8000:2107.04131:VOL:0A05 -t1 DS8000:2107.04131:VOL:0A06
session1

The following output is returned:

IWNR1000I  Copy sets were successfully created for the session 
named session1.

IWNR2001I  The pair, the ID of the source volume and the ID of the target volume,
was created in the session named session1 for the copy set with a 
volume ID of DS8000:2107.04131:VOL:0A05, a source volume ID of 
DS8000:2107.04131:VOL:0A05, and a target volume ID of DS8000:2107.04131:VOL:0A06.

Example: Creating a copy set for an IBM Storwize® V7000 FlashCopy session by using the volume ID

The following command creates a copy set for a FlashCopy session that is named session2. The host volume at site 1 is STORWIZE-V7000:VOL:FREEBIRD2:7 and the target volume is STORWIZE-V7000:VOL:FREEBIRD2:8.

csmcli> mkcpset -quiet -h1 STORWIZE-V7000:VOL:FREEBIRD2:7 -t1
STORWIZE-V7000:VOL:FREEBIRD2:8 session2

The following output is returned:

IWIWNR2001I The pair was created in session session2 for copy set
with a copy set ID of STORWIZE-V7000:VOL:FREEBIRD2:7, 
with a source volume ID of STORWIZE-V7000:VOL:FREEBIRD2:7(myvolume1),
and a target volume ID of STORWIZE-V7000:VOL:FREEBIRD2:8(myvolume2).

Example: Creating a copy set for a Storwize V7000 FlashCopy session by using the volume name

The following command creates a copy set for a FlashCopy session that is named session2. The host volume at site 1 is STORWIZE-V7000:VOL:FREEBIRD2:myvolume1 and the target volume is STORWIZE-V7000:VOL:FREEBIRD2:myvolume2.

csmcli> mkcpset -quiet -h1 STORWIZE-V7000:VOL:FREEBIRD2:myvolume1 -t1
STORWIZE-V7000:VOL:FREEBIRD2:myvolume2 session2

The following output is returned:

IWIWNR2001I The pair was created in session session2 for copy set
with a copy set ID of STORWIZE-V7000:VOL:FREEBIRD2:7, 
with a source volume ID of STORWIZE-V7000:VOL:FREEBIRD2:7(myvolume1),
and a target volume ID of STORWIZE-V7000:VOL:FREEBIRD2:8(myvolume2).

Example: Creating a copy set for an FlashSystem/IBM Spectrum Accelerate Snapshot session by using the volume ID

The following command creates the volume XIV:VOL:6000646:110789 for an FlashSystem/IBM Spectrum Accelerate Snapshot session that is named session3.

csmcli> mkcpset -h1 XIV:VOL:6000646:110789 session3

The following output is returned:

IWNR1000I Copy sets were created for the session named session3.

Example: Creating a copy set for an FlashSystem/IBM Spectrum Accelerate Snapshot session by using the volume name

The following command creates the volume XIV:VOL:6000646:myvolume for an FlashSystem/IBM Spectrum Accelerate Snapshot session that is named session3.

csmcli> mkcpset -h1 XIV:VOL:6000646:myvolume session3

The following output is returned:

IWNR1000I Copy sets were created for the session named session3.

Example: Creating a copy set for a SAN Volume Controller Global Mirror Failover/Failback with Change Volumes session

The following command creates a copy set for a Global Mirror Failover/Failback with Change Volumes session that is named session4. The host volume at site 1 is SVC:VOL:NYSVC08:1010 and the host change volume is SVC:VOL:NYSVC08:1011. The target volume is SVC:VOL:NYSVC08:1012 and the target change volume is SVC:VOL:NYSVC08:1013.

csmcli> mkcpset -h1 SVC:VOL:NYSVC08:1010 -c1 SVC:VOL:NYSVC08:1011 
-h2 SVC:VOL:NYSVC08:1012 -c2 SVC:VOL:NYSVC08:1013 session4

The following output is returned:

IWNR2001I The pair was created in session session4 for
copy set with a copy set ID of SVC:VOL:NYSVC08:1010,
with a source volume ID of SVC:VOL:NYSVC08:1010(tvdisk2010),
and a target volume ID of SVC:VOL:NYSVC08:1012(tvdisk2012).