Storage system: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Domain: | DEVICE |
Privileges: | TSOS |
/RESTORE-FROM-CLONE
When the command is executed, the data is copied from the clone unit to the original unit. No other access may take place to either of these units. The original unit can be accessed again after the copy process has been started.
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 units can be selected for reconstruction either explicitly (e.g. via the catalog ID of a renamed pubset) or implicitly according to their position in a SYSOUT output (*FROM-SHOW-OUTPUT(...) operand).
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 clones on ETERNUS DX/AF
After reconstruction has been completed, the clone pairs are still in the SPLIT status.
The pubset has to be exported for a restore on the pubset. The consistency for pubsets is enabled by the assignment of all original and clone units.
When the REC function is used, the original unit can also be the source unit of a remote copy pair. The target unit can also be the original unit of a clone pair. However, no reconstruction to the original unit is possible on the target unit.
For EC clones on ETERNUS DX/AF
Reconstruction takes place in SHC-OSD in several steps which are combined in the command.
After reconstruction has been completed, the clone pairs are still in the SPLIT status.
When the REC function is used, the original unit can also be the source unit of a remote copy pair. The target unit can also be the original unit of a clone pair. However, no reconstruction to the original unit is possible on the target unit.
For TimeFinder/Clone on Symmetrix/VMAX3
If multiple clone sessions exist for the same original unit and all of these are in the COPIED status, the command is executed for the selected units. If any of the unit’s clone sessions is in the RESTORED status, the command can only be executed for this session’s clone unit. The processing depends on the RESTORED-SESSION operand.
If the original unit also has snap units, the command is rejected.
If the original unit is also the target unit of a remote copy pair, the remote copy status must be IN-HOLD or ERROR, and TARGET-ACCESS must be DIRECT.
When the SRDF function is used, the original unit can also be the source unit of a remote copy pair. The target unit can also be the original unit of a clone pair. In this case the source unit is specified in the UNIT operand, and the clone pair of the target unit is selected using the SELECT=*TARGET-UNIT operand.
After the command has been executed the clone session is in the RESTORED status and cannot be used directly for anything else. Only the commands /STOP-CLONE-SESSION, /RESTART-CLONE-SESSION ... RESTORED-SESSION=*SPLIT-ONLY/*ACCEPT and another/RESTORE-FROM-CLONE ... RESTORED-SESSION=*ACCEPT are possible (see also "Re-creating a clone pair" and "Reconstructing the unit for Symmetrix/VMAX3"). While the clone session is in the RESTORED status, no other clone or snap session can be started with the same original unit.
WAIT=*UNTIL-RESTORED / *NO specifies whether the command waits (synchronous command execution) or not (asynchronous command execution) for reconstruction to be completed.
RESTORE-FROM-CLONE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Selects the units by means of a particular VSN (*BY-VOLUME), a particular catalog ID (*BY-PUBSET), by means of 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 logical volume's mnemonic device name.
UNIT = *BY-VOLUME(...)
Selects the units by means of a particular VSN.
VOLUME = <vsn 1..6>
Specifies the volume’s VSN.
UNIT = *BY-PUBSET(...)
Selects units by means of a pubset ID or volume set ID. The pubset is protected against reconfiguration during command processing. The relevant clone pubset is found automatically.
PUBSET = <cat-id 1..4>
Specifies the pubset ID or volume set ID.
CAUTION!
When a pubset is reconstructed from the clone units using UNIT=*BY-PUBSET(...), it may not have been reconfigured or, in particular, not have been reduced in size in the meantime. The clone units selected must contain a consistent pubset.
RENAME-PUBSET =
Specifies the pubset ID or volume set ID of the reconstructed pubset.
RENAME-PUBSET = *NO
The reconstructed pubset is not renamed. The pubset ID of the clone pubset is implicitly taken over.
RENAME-PUBSET = *SAME
The reconstructed pubset is renamed with the pubset ID or volume set ID of the original pubset.
RENAME-PUBSET = <cat-id 1..4>
The reconstructed pubset is renamed with the specified pubset ID or volume set ID.
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 = <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 clone unit. If more than one clone unit exists for a unit, a specific clone unit must be selected.
CLONE-UNIT = *FIRST-POSSIBLE
Selects the first possible clone unit for the command.
CLONE-UNIT = *FROM-SHOW-OUTPUT(...)
Selects the clone unit via its position in the output list of /SHOW-CLONE-SESSION-STATUS.
POSITION = <integer 1..16>
Specifies the position of the clone unit.
POSITION = *LAST
Selects the last clone unit in the output list.
CLONE-UNIT = *BY-PUBSET(...)
Selects the clone unit via the pubset ID of the activated and renamed pubset.
CLONE-PUBSET = <cat-id 1..4>
Specifies the pubset ID.
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 = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Specifies the mnemonic device name of the logical volume.
CLONE-TYPE=
Only relevant for ETERNUS DX/AF.
Specifies the clone type (and thus also the replication function) that is used.
CLONE-TYPE = *UNIQUE
Selects the clone type that is determined clearly by the explicit selection at CLONE-UNIT.
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.
RESTORED-SESSION =
Only relevant for Symmetrix/VMAX3.
Controls how a clone session or a session’s pairs are to be treated in the RESTORED status.
RESTORED-SESSION = *REJECT
For clone pairs in the RESTORED status the command is rejected with the message NDE2003.
RESTORED-SESSION = *ACCEPT
The command is executed for clone pairs in the RESTORED status. The clone pair is initially briefly placed in the SPLIT status, and then ultimately in the RESTORED status.
WAIT =
Specifies whether or not the command waits for reconstruction to be completed.
WAIT = *STD
For ETERNUS DX/AF only WAIT=*UNTIL-RESTORED can be used for a replication with EC. WAIT=*NO is used for Symmetrix/VMAX3.
WAIT = *NO
The command does not wait for reconstruction to be completed.
WAIT = *UNTIL-RESTORED
The command waits for reconstruction to be completed.
WAIT=*UNTIL-RESTORED
SELECT =
Selects the clone pairs.
SELECT = *STD
Selects the clone pairs which were defined using the UNIT operand.
SELECT = *TARGET-UNIT(...)
Selects the clone pairs which are assigned to the target unit of a remote copy pair. The relevant source unit is specified in the UNIT operand.
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 reconstruction of a clone unit which is also an SRDF source unit in the remote copy status ACTIVE.
FORCE = *NO
Reconstruction is rejected.
FORCE = *YES
Reconstruction is executed.
Command processing
The following messages are output to SYSOUT for each director and distributed via routing code 0, i.e. they are 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].
For successful processing
NDE1073For unsuccessful processing
NDE2007
Examples
/RESTORE-FROM-CLONE UNIT=*BY-PUBSET(PUBSET=TFC),CLONE-UNIT=*FIRST-POSSIBLE
/RESTORE-FROM-CLONE UNIT=*BY-VOLUME(VOLUME=TFC.00)
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 | NDE1005 | Pubset not homogeneous | |
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 | NDE1100 | Invalid pubset state | |
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 | NDE1143 | Error occurred during processing of mirror pair | |
64 | NDE1153 | Symmetrix device lock set | |
64 | NDE1154 | Disk belongs to a meta-disk | |
64 | NDE1171 | Target unit is not unique | |
64 | NDE1172 | RA group invalid for the specified unit | |
64 | NDE1531 | Different number of devices for units and clone unit | |
64 | NDE1535 | Device is a clone unit | |
64 | NDE1540 | Incorrect state of unit | |
64 | NDE1541 | Incorrect state of clone unit | |
64 | NDE1542 | Unit is an SRDF target unit and unit is not in *READY state | |
64 | NDE1548 | Clone type cannot be determined clearly | |
64 | NDE1549 | No clone unit assigned for clone unit selection | |
64 | NDE1553 | Device is not a clone unit | |
64 | NDE1702 | Connection to SYMAPI server aborted | |
64 | NDE1800 | Device not found or not in the 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 | NDE1811 | Function not supported for storage system | |
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 | NDE1822 | Reconstruction step | |
64 | NDE1823 | Reconstruction step | |
64 | NDE1824 | Reconstruction step | |
64 | NDE1833 | No suitable Storman server found | |
64 | NDE1853 | Storage unit locked | |
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 | |
130 | NDE1082 | Memory bottleneck during processing of command | |
130 | NDE2005 | Command cannot be executed at the moment |