SHC-OSD V14.0 (en)

Storage system:	ETERNUS DX/AF, Symmetrix/VMAX3
Domain:	DEVICE
Privileges:	TSOS

/RESTART-CLONE-SESSION updates a clone session and resets the clone unit of a clone pair to the status of the original/unit. The existing assignment between the unit and clone unit is retained.

When the command is executed, the data is copied from the original unit to the clone unit. No other access may take place to either of these units.

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.

For the restart the clone units can be selected explicitly (e.g. by means of 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 on ETERNUS DX/AF

The command is executed only if the clone pair has the SPLIT status. After the restart, the status of the clone pair changes from SYNCHRONIZING to SPLIT. The clone unit can be accessed by the host directly after this command has been executed. The data of the clone unit are updated in the background.

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. 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.

For EC on ETERNUS DX/AF

The command is executed only if the clone pair has the SPLIT status. After the restart, the status of the clone pair changes from SYNCHRONIZING to SYNCHRONIZED.

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. 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.

For TimeFinder/Clone on Symmetrix/VMAX3

/RESTART-CLONE-SESSION restarts an existing close session and resumes replication to the clone unit of a clone pair.

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.

RESTART-CLONE-SESSION

UNIT = BY-VOLUME(...) / BY-PUBSET(...) / BY-SYMMETRIX(...) / BY-STORAGE(...) /
			list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
	*BY-VOLUME(...)
		\|	VOLUME = <vsn 1..6>
	*BY-PUBSET(...)
		\|	PUBSET = <cat-id 1..4>
		\|	,NEW-PUBSET = SAME / SPECIAL-VSN / <cat-id 1..4>
		\|	,HOLD-IO = NO / UNTIL-ACTIVATED
	*BY-SYMMETRIX(...)
		\|	SERIAL-NUMBER = <alphanum-name 3..12>
		\|	,LOGICAL-VOLUME = <x-text 1..4>
	*BY-STORAGE(...)
		\|	SERIAL-NUMBER = <alphanum-name 3..14>
		\|	,LOGICAL-VOLUME = <x-text 1..4>
,CLONE-UNIT = FIRST-POSSIBLE / FROM-SHOW-OUTPUT(...) / *BY-PUBSET(...) /
				BY-SYMMETRIX(...) / BY-STORAGE(...) /
				list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
	*FROM-SHOW-OUTPUT(...)
		\|	POSITION = <integer 1..16> / *LAST
	*BY-PUBSET(...)
		\|	CLONE-PUBSET = <cat-id 1..4>
	*BY-SYMMETRIX(...)
		\|	CLONE-LOGICAL-VOLUME = <x-text 1..4>
	*BY-STORAGE(...)
		\|	CLONE-LOGICAL-VOLUME = <x-text 1..4>
,CLONE-TYPE = UNIQUE / COPY / *MIRROR
,RESTORED-SESSION = STD / REJECT / ACCEPT / SPLIT-ONLY
,SELECT = STD / TARGET-UNIT(...)
	*TARGET-UNIT(...)
		\|	RA-GROUP = *UNIQUE / <integer 1..250>
,FORCE = NO / YES
,WAIT = NO / UNTIL-SYNCHRONIZATION

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.

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 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 = *BY-STORAGE(...)
Only relevant for ETERNUS DX/AF.
Selects the 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.
Determines how a clone session or a session’s pairs are to be treated in the RESTORED status.

RESTORED-SESSION = *STD
*REJECT is taken as the default value.

RESTORED-SESSION = *REJECT
The command is rejected for clone pairs in the RESTORED status.

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 in the RECREATED or PRECOPY status.

RESTORED-SESSION = *SPLIT-ONLY
The command is executed for clone pairs in the RESTORED status. The clone pairs are placed in the SPLIT status and remain in this status until another action is performed.

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.

FORCE =
Only relevant for Symmetrix/VMAX3.
FORCE controls the restart of a clone session with a clone unit which is also an SRDF source unit in the remote copy status ACTIVE.

FORCE = *NO
The restart is rejected.

FORCE = *YES
The restart is executed. The remote copy status changes to ERROR.

WAIT =
Only relevant for ETERNUS DX/AF.
Specifies whether 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 simplifies the programming of test procedures because extensive queries regarding the synchronization progress are unnecessary.

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 NDE1073
For unsuccessful processing NDE2007

Examples

/RESTART-CLONE-SESSION UNIT=*BY-PUBSET(PUBSET=TFC),CLONE-UNIT=*FROM-SHOW-OUTPUT(POSITION=2)

/RESTART-CLONE-SESSION 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	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	`SELECT=*TARGET-UNIT`: `UNIT` is not a source unit
	64	NDE1109	`SELECT=*TARGET-UNIT`: `TARGET-UNIT` not found
	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	NDE1530	No clone function for the 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	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	NDE1854	Clone pair possibly inconsitent
	64	NDE1890	Management instance not found
	64	NDE1899	Command not possible for current status of the mirror pair
	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

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

RESTART-CLONE-SESSION Re-creating a clone pair