mkcpset
Use the mkcpset command to create copy sets.
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.
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.
- -h1 {h1_volume_id | h1_volume_name}
- Specifies the host volume for the copy set at site 1.
- -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.
- 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.
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).