STOP-REMOTE-COPY Cancels a remote copy pair

Storage system:	ETERNUS DX/AF
Domain:	DEVICE
Privileges:	TSOS


/STOP-REMOTE-COPY terminates one or mote remote copy pairs.

The source unit is selected using the UNIT operand.

The target unit is normally selected implicitly using the UNIT operand. When multiple remote replication of a source unit is used the selection is performed by directly by specifying the target unit.

All remote mirror pairs of a server or of an entire controller can be canceled via the qualitative selection of the source units.

The command is executed only if the remote copy pair is in the remote copy state ERROR, IN-HOLD or BROKEN.

The command is executed only for source units.

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

STOP-REMOTE-COPY

UNIT = *BY-VOLUME(...) / *BY-PUBSET(...) / *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>
	*BY-STORAGE(...)
		|	SERIAL-NUMBER = <alphanum-name 3..14>
		|	,LOGICAL-VOLUME = *ALL-SOURCE-UNITS(...) / <x-text 1..4>
		|		*ALL-SOURCE-UNITS(...)
		|			|	SELECT = *ANY / *ALL-DEFINED / *ATTACHED
,TARGET-UNIT(...) = *UNIQUE / *ALL / *FIRST-POSSIBLE / *BY-STORAGE(...)
	*BY-STORAGE(...)
		|	TARGET-SERIAL-NUMBER = <alphanum-name 3..14>
,FORCE = *NO / *YES
,TARGET-VSN = *KEEP / *DESTROY

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.

PUBSET = <cat-id 1..4>
Specifies the pubset ID or volume set ID.

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 = *ALL-SOURCE-UNITS(...)
Selects the source units of the storage system.

SELECT = *ANY
Selects all source units of the specified storage system.

SELECT = *ALL-DEFINED
Selects all source units (generated in BS2000) of the specified storage system.

SELECT = *ATTACHED
Selects all source units (attached in BS2000) of the specified storage system.

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 source unit by means of the mnemonic name of the logical volume.

TARGET-UNIT =
Selects the target unit(s) of the remote copy pair.

TARGET-UNIT = *UNIQUE
Selects the only and unambiguous target unit(s). Always applies when there is only one single target unit for a source unit.

TARGET-UNIT = *ALL
All target units which are possibly assigned to one source unit are selected and the corresponding remote copy pairs are canceled.

TARGET-UNIT = *FIRST-POSSIBLE
Selects the first possible target unit for the command.

TARGET-UNIT = *BY-STORAGE(...)
Selects the target unit by means of the serial number and the internal number of the logical volume in the storage system.

TARGET-SERIAL-NUMBER = <alphanum-name 3..14>
Specifies the serial number of the storage system (make sure it is unique!) with the target unit.

FORCE =
FORCE controls the termination of a remote copy pair.

FORCE = *NO
The termination of a remote copy pair is possibly be rejected with a message.
The command is rejected if the remote copy pair is in ERROR status.

FORCE = *YES
The termination of a remote copy pair is always executed.
When only one storage system can be reached, the remote copy pair can only be canceled on this system. If necessary the command must be repeated with FORCE=*YES when the failed system is available again.

TARGET-VSN =
TARGET-VSN controls how the VSN is handled on the target unit after the remote copy pair has terminated This is only possible for attached BS2000 devices.

TARGET-VSN = *KEEP
The VSN on the target unit remains unchanged.

TARGET-VSN = *DESTROY
The VSN on the target unit is deleted. The device is then no longer usable in BS2000.

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	NDE1008	Volume cannot be allocated
	64	NDE1015	Device not defined in BS2000
	64	NDE1020	No remote copy function for the specified unit
	64	NDE1021	Device is not a source unit
	64	NDE1043	Pubset type not supported
	64	NDE1067	Remote copy pair not yet synchronized
	64	NDE1076	Local synchronization has not yet taken place
	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	NDE1140	Duplicate MN in MN list
	64	NDE1143	Error occurred during processing of mirror pair
	64	NDE1144	Source unit(s) and target unit(s) are identical
	64	NDE1145	Source unit(s) and target unit(s) on the same storage system
	64	NDE1148	Different number of devices for source unit(s) and target unit(s)
	64	NDE1171	Target unit not unique
	64	NDE1177	Device is a source unit
	64	NDE1178	Device is a target unit
	64	NDE1179	Device is a cascaded target unit
	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	NDE1833	No suitable Storman server found
	64	NDE1853	Storage unit locked
	64	NDE1866	No remote link available
	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	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