Storage system: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Domain: | DEVICE |
Privileges: | TSOS |
/STOP-CLONE-SESSION
On command execution, the clone unit again assumes the status of a normal device without clone function. The information function for the unit shows no clone use after the connection to the last clone unit has been canceled.
When the original units are selected via a pubset (UNIT=*BY-PUBSET), clone units must exist for all units of the pubset.
When the clone session terminates, the clone unit can be destroyed if it is no longer needed (invalid VSN).
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 and EC on ETERNUS DX/AF
If the clone session is in the SYNCHRONIZING status, it must be terminated using the FORCE=*YES operand.
For TimeFinder/Clone on Symmetrix/VMAX3
The clone session can be in any status (see the section "Status of the clone session and of the devices"). If the clone session is in the COPY-IN-PROGRESS status, it must be terminated using the FORCE=*YES operand.
STOP-CLONE-SESSION | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
PUBSET = <cat-id 1..4>
Specifies the 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 = 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 = *ALL
Selects all clone units.
CLONE-UNIT = *RESTORED
Only relevant for Symmetrix/VMAX3.
Selects the clone unit in the *RESTORED status.
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 = *BY-STORAGE(...)
Only relevant for ETERNUS DX/AF.
Selects the clone unit by means of the serial number and 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.
A 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 = *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.
FORCE =FORCE controls the termination of a clone session.
FORCE = *NO
Termination of a clone session in the COPY-IN-PROGRESS / SYNCHRONIZING status is rejected with a message.
FORCE = *YES
The clone session is terminated irrespective of its status. The clone pair is canceled.
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.
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.
CLONE-VSN =
Controls how the VSN is handled on the clone unit after the clone session has terminated This is only possible for attached BS2000 devices.
CLONE -VSN = *KEEP
The VSN on the clone unit remains unchanged.
CLONE -VSN = *DESTROY
The VSN on the clone unit is deleted. It can then no longer be used in BS2000.
Command processing
The following messages are output to SYSOUT for each clone pair 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
/STOP-CLONE-SESSION UNIT=5000,CLONE-UNIT=*ALL
/STOP-CLONE-SESSION UNIT=*BY-PUBSET(PUBSET=TFC)
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 | NDE1150 | No gatekeeper device found | |
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 | NDE1530 | No clone function for the unit | |
64 | NDE1531 | Different number of devices in the unit and clone unit specifications | |
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 | 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 | 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 | NDE1833 | No suitable Storman server found | |
64 | NDE1853 | Storage unit locked | |
64 | NDE1890 | Management instance not found | |
64 | NDE1897 | Command execution only with FORCE=*YES | |
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 |