Storage system: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Domain: | DEVICE |
Privileges: | TSOS |
/START-CLONE-SESSION
Clone units can be cascaded, i.e. a clone unit can also be the original unit of another clone pair.
The original units of the clone pairs are specified in the UNIT operand.
When the original units are selected via a pubset (UNIT=*BY-PUBSET), clone units must exist for all units of the pubset. The clone pubset on the clone units can be renamed for ETERNUS DX/AF with QuickOPC directly using the NEW-PUBSET operand if an SF pubset is involved.
A /START-CLONE-SESSION command enables clone units to be generated for all units of a pubset. In this case the pubset is selected using UNIT. In CLONE-UNIT a list of devices is specified which are not yet being used as clone units and whose number matches the number of units in the pubset.
SHC-OSD checks the global and task-specific security settings before this command is executed (see "Security settings of SHC-OSD"). The current security settings can be displayed with /SHOW-SHC-PROCESSING (see also "SHOW-SHC-PROCESSING Displays settings of SHC-OSD"). They can be changed in the SHC-OSD parameter file (see "Configuration of SHC-OSD") for the next time SHC-OSD is started or with /MODIFY-SHC-PROCESSING for ongoing operations (see "MODIFY-SHC-PROCESSING Changes settings of SHC-OSD").
For QuickOPC on ETERNUS DX/AF
By executing this command the synchronization of the clone pair is implicitly started. The clone unit can be accessed by the host directly after this command has been executed. The clone pair is synchronized in the background. It assumes the status SYNCHRONIZING. After synchronization has been concluded, the clone pair automatically receives the status SPLIT.
The maximum number of mirrors per unit in the storage system is 32.
Cancelation of the pair connection using /STOP-CLONE is only possible in the SPLIT status.
For EC on ETERNUS DX/AF
Executing the command implicitly starts synchronization of the clone pair, and the clone pair assumes the SYNCHRONIZING status. After initial synchronization has been completed, the pair is in the SYNCHRONIZED status.
The clone unit cannot be accessed by the host after this command has been executed.
QuickOPC clone units can be bigger than the original unit. /RESTORE-FROM-CLONE is not possible for those pairs.
The clone unit can then be activated with /ACTIVATE-CLONE, which makes it accessible for the host. This is only possible in the SYNCHRONIZED status.
The maximum number of mirrors per unit in the storage system is 32.
Cancelation of the pair connection using /STOP-CLONE is only possible in the SYNCHRONIZED status.
For TimeFinder/Clone on Symmetrix/VMAX3
On command execution, the clone pair assumes the CREATED or PRECOPY state. The clone unit can then be activated using /ACTIVATE-CLONE (see "ACTIVATE-CLONE Activates a clone pair"), thus making it accessible to the host.
The clone unit cannot be accessed by the host after this command has been executed.
TimeFinder clone units can be larger than the original unit.
The clone pair is created in a way that allows a later restart or restoration.
Up to 16 clone units can be configured for a unit. This maximum number is determined by the current strage systems, which are currently limited to a maximum of 16 copy sessions per original device. This value consists of the sum of the BCV, clone and snap sessions which are active at a given time.
If snap or clone session in the RESTORED status already exist for the original unit, the /START-CLONE-SESSION command is rejected.
START-CLONE-SESSION | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Selects the units by means of a particular catalog ID (*BY-PUBSET), via the serial number and the internal number of the logical volume in the storage system (*BY-SYMMETRIX/*BY-STORAGE), or directly by means of the mnemonic device name of the logical volume.
UNIT = *BY-PUBSET(...)
Selects units by means of a pubset ID or volume set ID. The pubset is protected against reconfiguration during command processing.
PUBSET = <cat-id 1..4>
Specifies the pubset ID or volume set ID.
NEW-PUBSET =
Only relevant for ETERNUS DX/AF with QuickOPC.
Determines the catalog ID of the clone pubsets of the clone units.
NEW-PUBSET = *SAME
The clone pubset is not renamed, i.e. it retains the same name.
NEW-PUBSET = *SPECIAL-VSN
All volumes of the clone units are automatically renamed to prevent confusion with the original. For this purpose the period in a VSN in point notation is changed to a colon (e.g. AA.001 to AA:001), or in PUB notation the PUB string is changed to P:B (e.g. PUBA01 to P:BA01).
NEW-PUBSET = <cat-id 1..4>
An SF pubset’s clone pubset is renamed by specifying the new catalog ID explicitly. The catalog ID can also differ in length from the PUBSET operand. The new clone pubset also becomes an SF pubset. An existing MRSCAT entry is used if it is of the correct type. If it is not, it is deleted and created again. See the notes in section "Renaming SF pubsets with SHC-OSD".
HOLD-IO =
Only relevant for ETERNUS DX/AF with QuickOPC.
Handles inputs/outputs on the clone pair during splitting (see “Consistent splitting of a pubset in the shared pubset network” in "Synchronization point for replications").
HOLD-IO = *NO
The inputs/outputs on the original units are executed without any change. This can lead to data inconsistencies on the clone units for applications which are not suspended before splitting takes place.
HOLD-IO = *UNTIL-ACTIVATED
The inputs/outputs on the original units are suspended until all the imported pubset’s clone pairs are in the COPY-ON-WRITE status. Subsequently inputs/outputs to the units are resumed. If an error occurs when inputs/outputs are suspended or resumed, the command is aborted. The input/output activity may need to be resumed using /RESUME-IO.
UNIT = *BY-SYMMETRIX(...)
Only relevant for Symmetrix/VMAX3.
Selects the unit by means of the serial number of the storage system and the internal number of the logical volume in the storage system.
SERIAL-NUMBER = <alphanum-name 3..12>
Specifies the serial number of the storage system (make sure it is unique!).
LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system
UNIT = *BY-STORAGE(...)
Only relevant for ETERNUS DX/AF.
Selects the unit by means of the serial number and the internal number of the logical volume in the storage system.
SERIAL-NUMBER = <alphanum-name 3..14>
Specifies the serial number of the storage system (make sure it is unique!).
LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system
UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Selects the unit by means of the mnemonic device name of the logical volume.
CLONE-UNIT =
Selects the device for the clone unit by means of the mnemonic device name of the logical volume or by means of its internal number in the storage system.
CLONE-UNIT = *BY-SYMMETRIX(...)
Only relevant for Symmetrix/VMAX3.
Selects the clone unit by means of the internal number of the logical volume in the storage system.
CLONE-LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system
CLONE-UNIT = *BY-STORAGE(...)
Only relevant for ETERNUS DX/AF.
Selects the clone unit by means of the internal number of the logical volume in the storage system.
LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system
CLONE-UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Specifies the mnemonic device name of the logical volume. A unit list is accepted only if a pubset was specified in the UNIT operand.
CLONE-TYPE=
Only relevant for ETERNUS DX/AF.
Specifies the clone type (and thus also the replication function) that is used.
CLONE-TYPE = *BY-PRESELECTION
The clone type preset in the SHC-OSD parameter file is used. Presetting in the SHC-OSD parameter file: MIRROR.
CLONE-TYPE = *COPY
The COPY clone type (and thus the QuickOPC replication function) is selected.
CLONE-TYPE = *MIRROR
The MIRROR clone type (and thus the replication function EC) is selected.
SELECT =
Defines whether the unit specified in the UNIT operand or (when remote replication is used) the target unit of a remote copy pair is selected as the original unit of the clone pair.
SELECT = *STD
Selects the unit which was defined in the UNIT operand.
SELECT = *TARGET-UNIT(...)
Selects the target unit of a remote copy pair as the original unit. The relevant source unit is specified in the UNIT operand. For ETERNUS DX/AF the selection can only be made if the target unit is unique. Concurrent remote copy is not supported here.
RA-GROUP =
Only relevant for Symmetrix/VMAX3.
Selects the target unit using the RA group in the case of concurrent target units.
RA-GROUP = *UNIQUE
Selects the one existing target unit.
RA-GROUP = <integer 1..250>
Specifies the RA group for selecting the target unit.
FORCE =
Only relevant for Symmetrix/VMAX3.FORCE controls the start of a clone session with a clone unit which is also an SRDF source unit in the remote copy status ACTIVE.
FORCE = *NO
The clone session is not started.
FORCE = *YES
The clone session is started. The remote copy status changes to ERROR.
WAIT =
Specifies whether or not the command is to wait until synchronization is complete.
WAIT = *NO
The command does not wait until synchronization is complete.
WAIT = *UNTIL-SYNCHRONIZATION
The command waits until synchronization is complete.
WAIT=*UNTIL-SYNCHRONIZATION
Waiting can be aborted for Symmetrix/VMAX3 in dialog mode by hitting the K2 key.
Command processing
Message NDE1073 is output to SYSOUT for each device and distributed via routing code 0, i.e. it is logged in the CONSLOG file only. You will find detailed information on the CONSLOG file (log file) in the “Introduction to System Administration” manual [5].
Examples
/START-CLONE-SESSION UNIT=5000,CLONE-UNIT=5040,CLONE-TYPE=*MIRROR
/START-CLONE-SESSION UNIT=*BY-PUBSET(PUBSET=TFC),
CLONE-UNIT=(5100,5101,5102)
(Pubset TFC consists of 3 units)
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command executed successfully | |
1 | 0 | NDE2003 | Command successfully executed, no processing necessary |
2 | 0 | NDE2004 | Command successfully executed but not yet completed |
1 | CMD0202 | Syntax error | |
32 | NDE2002 | Internal error | |
64 | CMD0087 | Function not permitted in the current input mode or with the current task privileges | |
64 | CMD0216 | Required privilege not available | |
64 | NDE1000 | Device not found or not in the storage system | |
64 | NDE1001 | Device not attached | |
64 | NDE1003 | Data medium not online or not unique | |
64 | NDE1004 | Pubset not found or wrong pubset type | |
64 | NDE1006 | Pubset/volume is allocated | |
64 | NDE1008 | Volume cannot be allocated | |
64 | NDE1010 | Enginuity version is not supported (too low) | |
64 | NDE1015 | Device not defined in BS2000 | |
64 | NDE1043 | Pubset type not supported | |
64 | NDE1052 | Maximum number of TimeFinder mirrors exceeded | |
64 | NDE1057 | Function not supported | |
64 | NDE1100 | Invalid pubset state | |
64 | NDE1101 | More than one sharer for pubset | |
64 | NDE1102 | Not all volumes could be allocated | |
64 | NDE1103 | No reconfiguration lock for pubset | |
64 | NDE1105 | Inconsistent pubset | |
64 | NDE1108 |
| |
64 | NDE1109 |
| |
64 | NDE1114 | Serial number not found | |
64 | NDE1115 | Serial number not unique | |
64 | NDE1116 | Storage system’s logical volume not found | |
64 | NDE1140 | Duplicate MN in MN list | |
64 | NDE1142 | Mirror pair already exists | |
64 | NDE1143 | Error occurred during processing of mirror pair | |
64 | NDE1150 | No gatekeeper device found | |
64 | NDE1153 | Symmetrix device lock set | |
64 | NDE1154 | Disk belongs to a meta-disk | |
64 | NDE1155 | RAID10 devices not supported | |
64 | NDE1171 | Target unit is not unique | |
64 | NDE1172 | RA group invalid for the specified unit | |
64 | NDE1181 | Maximum number of internal mirrors reached | |
64 | NDE1435 | Device is a virtual device | |
64 | NDE1511 | Clone pair is already cascaded | |
64 | NDE1531 | Different number of devices for units and clone unit | |
64 | NDE1534 | Clone unit used in other Snap or Clone pair | |
64 | NDE1535 | Device is a clone unit | |
64 | NDE1537 | MNs or device numbers of unit and Clone unit are dentical | |
64 | NDE1538 | Unit and Clone unit of different type or size | |
64 | NDE1539 | Unit and Clone unit on different storage systems | |
64 | NDE1540 | Incorrect state of unit | |
64 | NDE1541 | Incorrect state of clone unit | |
64 | NDE1558 | Unit and Clone unit meta volumes of different stripe size | |
64 | NDE1702 | Connection to SYMAPI server aborted | |
64 | NDE1800 | Device not found or not in storage system | |
64 | NDE1802 | Error communicating with StorMan server | |
64 | NDE1803 | Management instance not available | |
64 | NDE1810 | Storage system’s operating system version not supported | |
64 | NDE1812 | StorMan server switched off by command | |
64 | NDE1814 | Storage system’s serial number not found | |
64 | NDE1815 | Storage system’s serial number not unique | |
64 | NDE1816 | Storage system’s logical volume not found | |
64 | NDE1839 | Unit and Clone unit on different storage systems | |
64 | NDE1852 | Maximum number of local mirrors exceeded | |
64 | NDE1853 | Storage unit locked | |
64 | NDE1880 | Copy license not installed (ETERNUS DX/AF) | |
64 | NDE1881 | Copy Table Size not configured (ETERNUS DX/AF) | |
64 | NDE1882 | Copy Table Size too small (ETERNUS DX/AF) | |
64 | NDE1883 | Advanced Copy operations for devices locked (ETERNUS DX/AF) | |
64 | NDE1890 | Management instance not found | |
64 | NDE1899 | Command not possible for current status of the mirror pair | |
64 | NDE2000 | Execution partially successful | |
64 | NDE2001 | Command not executed | |
64 | NDE2009 | Command aborted with K2 key | |
64 | NDE2011 | Symmetrix license not entered | |
64 | NDE2013 | SYMAPI error in command | |
64 | NDE2014 | StorMan error in command | |
64 | NDE2017 | Command not possible for current status of the replication | |
64 | NDE2018 | Error on SYMAPI server during the current editing | |
64 | NDE2020 | No license for local replication (ETERNUS DX/AF) | |
130 | NDE1082 | Memory bottleneck during processing of command | |
130 | NDE2005 | Command cannot be executed at the moment | |