Chapter 9. FlashCopy interfaces 79
Example 9-3 setflashrevertible command examples
#------------------------------------------------------------
#--- script to set FlashCopy property Revertible to value enabled and display values afterwards
#------------------------------------------------------------
#--- Example 1
setflashrevertible -dev IBM.1750-13ABC2A 0002:0102
Date/Time: July 8, 2005 6:52:49 PM CEST IBM DSCLI Version: 5.0.3.134 DS: IBM.1750-13ABC2A
CMUC00167I setflashrevertible: FlashCopy volume pair 0002:0102 successfully made revertible.
lsflash -dev IBM.1750-13ABC2A 0000-0004
Date/Time: July 8, 2005 7:15:30 PM CEST IBM DSCLI Version: 5.0.3.134 DS: IBM.1750-13ABC2A
ID SrcLSS SequenceNum Timeout ActiveCopy Recording Persistent Revertible SourceWriteEnabled TargetWriteEnabled BackgroundCopy
====================================================================================================================================
0002:0102 00 0 300 Disabled Enabled Enabled Enabled Enabled Disabled Enabled
#--- Example 2
setflashrevertible -dev IBM.1750-13ABC2A 0003:0103
Date/Time: July 8, 2005 6:53:16 PM CEST IBM DSCLI Version: 5.0.3.134 DS: IBM.1750-13ABC2A
CMUN03027E setflashrevertible: 0003:0103: FlashCopy operation failure: action prohibited by current FlashCopy state
The following explanations apply to the cases presented in Example 9-3:
Example 1: set the FlashCopy relationship to Revertible.
This command will set the existing FlashCopy for source volume 0002 and target volume
0102 to revertible. Once the property Revertible is enabled, any subsequent commands
will result in an error message similar to the one displayed in Example 2.
Example 2: error occurs when trying to set FlashCopy relationship to revertible.
When trying to set a FlashCopy relationship to Revertible for which the property Recording
is disabled, an error will result. The script will end after this command with return code 2
and any other commands following the one that caused the error will not be executed.
Commit data to target using commitflash
The command commitflash can be used to commit data to a target volume to set consistency
between source and target. It is intended to be used in asynchronous remote copy
environments such as Global Mirror. Therefore, its usage is discussed in greater detail in Part
6, “Global Mirror” on page 265, while this section discusses the basic use of the command.
Before the FlashCopy relationship can be committed, it needs to be made revertible.
Typically, this is done automatically by an application such as Global Mirror. However, it can
also be set manually.
Example 9-4 Commit command examples
#--- Example 1
lsflash -dev IBM.1750-13ABC2A 0000-0005
Date/Time: July 10, 2005 2:45:28 PM CEST IBM DSCLI Version: 5.0.3.134 DS: IBM.1750-13ABC2A
ID SrcLSS SequenceNum Timeout ActiveCopy Recording Persistent Revertible SourceWriteEnabled TargetWriteEnabled BackgroundCopy
======================================================================================================================================
0001:0101 00 1 300 Disabled Enabled Enabled Disabled Disabled Disabled Enabled
0005:0105 00 1 300 Disabled Enabled Enabled Disabled Disabled Disabled Enabled
setflashrevertible -dev IBM.1750-13ABC2A -seqnum 01 0001:0101 0005:0105
Date/Time: July 10, 2005 2:45:40 PM CEST IBM DSCLI Version: 5.0.3.134 DS: IBM.1750-13ABC2A
CMUC00167I setflashrevertible: FlashCopy volume pair 0001:0101 successfully made revertible.
CMUC00167I setflashrevertible: FlashCopy volume pair 0005:0105 successfully made revertible.
lsflash -dev IBM.1750-13ABC2A 0000-0005
Date/Time: July 10, 2005 2:46:07 PM CEST IBM DSCLI Version: 5.0.3.134 DS: IBM.1750-13ABC2A
ID SrcLSS SequenceNum Timeout ActiveCopy Recording Persistent Revertible SourceWriteEnabled TargetWriteEnabled BackgroundCopy
======================================================================================================================================
0001:0101 00 1 300 Disabled Enabled Enabled Enabled Enabled Disabled Enabled
0005:0105 00 1 300 Disabled Enabled Enabled Enabled Enabled Disabled Enabled