Storage system: | ETERNUS DX/AF |
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
After reconstruction has been completed, the clone pairs are still in the SPLIT status.
The original pubset has to be exported for a restore on the pubset. The file consistency over multiple volumes must be ensured by the caller.
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
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.
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-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.
HOLD-IO =
Only relevant for QuickOPC.
Handles inputs/outputs on the clone pair during the start of restoring (see “Consistent splitting of a pubset in the shared pubset network” in "Synchronization point for replications").
HOLD-IO = *NO
The inputs/outputs on the clone units are executed without any change. This can lead to data inconsistencies on the original units for applications which are not suspended before restoring takes place.
HOLD-IO = *UNTIL-RESTORED
The inputs/outputs on the clone units are suspended until all the imported clone pubset’s clone pairs are in the REST-IN-PROG status. Subsequently inputs/outputs to the clone units are resumed. If an error occurs when inputs/outputs are suspended or resumed, the command is aborted with the message NDE1120, an optional renaming of the original pubset is not done any more, the already reconstructed original pubset keeps the implicitly taken over pubset ID of the clone pubset. The input/output activity may need to be resumed using /RESUME-IO.
UNIT = *BY-STORAGE(...)
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 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 = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Specifies the mnemonic device name of the logical volume.
CLONE-TYPE=
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.
WAIT =
Specifies whether or not the command waits for reconstruction to be completed.
WAIT = *STD
Only WAIT=*UNTIL-RESTORED can be used for a replication with EC.
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.
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 | NDE1015 | Device not defined in BS2000 | |
64 | NDE1043 | Pubset type not supported | |
| 64 | NDE1057 | Function not supported | |
| 64 | NDE1087 | HOLD-IO=*UNTIL-RESTORED permitted only for imported pubsets | |
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 | NDE1120 | Error suspending or resuming input/output access to pubset | |
64 | NDE1143 | Error occurred during processing of mirror pair | |
64 | NDE1171 | Target unit is not unique | |
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 | 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 | 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 | NDE2014 | StorMan error in command | |
64 | NDE2017 | Command not possible for current status of the replication | |
130 | NDE1082 | Memory bottleneck during processing of command | |
130 | NDE2005 | Command cannot be executed at the moment |