SWAP-REMOTE-COPY Swaps the source and target property of a remote copy pair

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

The /SWAP-REMOTE-COPY command swaps the source and target property of a remote copy pair.
It can be used to swap the target unit for the source unit after a failover in order to continue working with the source unit with the same failsafe feature as before.
It cannot be used in configurations with concurrent remote copy.
Source and target tnita must be of the same size.

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 REC on ETERNUS DX/AF

Before entering the command, you must interrupt remote copy mode (remote copy status IN-HOLD or ERROR). Typically it is interrupted when a failure occurs (remote copy status ERROR). The command can be entered in both synchronous and asynchronous operating mode.

After the command has been executed successfully, no automatic resynchronization of the new source target pair takes place.

The TARGET-UNIT operand controls the selection of the target unit when switching from cascaded remote copy to concurrent remote copy or vice versa.

For SRDF on Symmetrix/VMAX3:

Before entering the command, you must interrupt remote copy mode and activate direct access to the target unit (IN-HOLD remote copy state and DIRECT target access).

With SRDF swap, both the source unit and the target unit must have the dynamic SRDF capability *ANY. The dynamic SRDF capability of units can be displayed using /SHOW-SYMMETRIX-DEVICE-CONFIG.

Concurrent remote copy must not be in progress when source and target unit are swapped, i.e. the source unit must have only one target unit. 

SWAP-REMOTE-COPY

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>
	*BY-SYMMETRIX(...)
		|	SERIAL-NUMBER = <alphanum-name 3..12>
		|	,LOGICAL-VOLUME = *ALL-SOURCE-UNITS(...) / *ALL-TARGET-UNITS(...) / <x-text 1..4>
		|		*ALL-SOURCE-UNITS(...)
		|			|	SELECT = *ANY / *ALL-DEFINED / *ATTACHED
		|			|	,RA-GROUP = *ANY / <integer 1..250>
		|		*ALL-TARGET-UNITS(...)
		|			|	SELECT = *ANY / *ALL-DEFINED / *ATTACHED
		|			|	,RA-GROUP = *ANY / <integer 1..250>
	*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-STATE = *STD / *NOT-READY / *READ-ONLY
,TARGET-UNIT = *UNIQUE / *BY-STORAGE(...) / <alphanum-name 2..2> / <x-text 4..4>
	*BY-STORAGE(...)
		|	TARGET-SERIAL-NUMBER = <alphanum-name 3..14>

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.

If *BY-VOLUME, *BY-PUBSET is specified, the action is selected for the source unit automatically. If a mnemonic name or *BY-SYMMETRIX is specified, source units and target units are permitted.

UNIT = *BY-VOLUME(...)
Selects the source units by means of a specific VSN.

VOLUME = <vsn 1..6>
Specifies the volume’s VSN.

UNIT = *BY-PUBSET(...)
Selects the source 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 source or target 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 = *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.

RA-GROUP = *ANY
Selects all RA groups.

RA-GROUP = <integer 1..250>
Selects all source units of an RA group.

LOGICAL-VOLUME = *ALL-TARGET-UNITS(...)
Selects the target units of the storage system.

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

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

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

RA-GROUP = *ANY
Selects all RA groups.

RA-GROUP = <integer 1..250>
Selects all target units of an RA group.

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

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.

TARGET-STATE =
Only relevant for Symmetrix/VMAX3.
Specifies the state setting for the target units.

TARGET-STATE = *STD
The target unit setting depends on generation in BS2000. The NOT-READY state is set by default for generated target units to prevent ambiguous VSNs in BS2000 operation. The READ-ONLY state is set for all other target units, e.g. all target units of non-BS2000 systems.

TARGET-STATE = *NOT-READY
Sets the NOT-READY state for all target units.

TARGET-STATE = *READ-ONLY
Sets the READ-ONLY state for all target units.

TARGET-UNIT =
Only relevant for ETERNUS DX/AF.
Controls the selection of the target unit when switching from cascaded remote copy to concurrent remote copy or vice versa.

TARGET-UNIT = *UNIQUE
Remote copy mode is started for the one existing target unit.

TARGET-UNIT = *BY-STORAGE(...)
Selects the target unit using the serial number 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.

Command processing

The following messages are output to SYSOUT for each device 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

Example

/SWAP-REMOTE-COPY UNIT=*BY-PUBSET(PUBSET=RDF)

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
3	0	NDE1067	Remote copy pair not yet synchronized
3	0	NDE1069	No current information available about some remote copy pairs
	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	NDE1002	Controller not found
	64	NDE1003	Data medium not online or not unique
	64	NDE1004	Pubset not found or wrong pubset type
	64	NDE1005	Pubset not homogeneous
	64	NDE1010	Enginuity version is not supported (too low)
	64	NDE1015	Device not defined in BS2000
	64	NDE1020	No remote copy function for the specified unit
	64	NDE1028	Volume not unique in the unit
	64	NDE1061	Remote copy state is not IN-HOLD
	64	NDE1063	Source unit does not have the state READY
	64	NDE1066	No remote link director available
	64	NDE1079	None of the selected devices is attached
	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	NDE1107	No pubset allocation possible
	64	NDE1114	Serial number not found
	64	NDE1115	Serial number not unique
	64	NDE1116	Storage system’s logical volume not found
	64	NDE1150	No gatekeeper device found
	64	NDE1153	Symmetrix device lock set
	64	NDE1154	Disk belongs to a meta-disk
	64	NDE1160	Access to target unit of the remote copy pair is BY-SOURCE
	64	NDE1162	Swap not possible
	64	NDE1164	Conflict between RESUME-PARAMETER and pending updates
	64	NDE1165	Swap *RESTORE-TO-SOURCE not possible in secure mode
	64	NDE1166	Swap with RESUME-PAR=*ANY not possible with static swap
	64	NDE1167	Configuration session lock is set
	64	NDE1168	Error during configuration change
	64	NDE1170	Source unit has concurrent target units
	64	NDE1179	Device is a cascaded target unit
	64	NDE1190	Command for COPY-MODE=ASYNCHRON for entire RA group only
	64	NDE1193	Command not allowed if target unit is larger than source unit
	64	NDE1194	Command not allowed if SRDF Farpoint is in use
	64	NDE1535	Device is a clone unit
	64	NDE1611	Device is an SCO volume (ETERNUS DX/AF)
	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	CIMOM 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	NDE1842	Configuration error in the REC buffer
	64	NDE1853	Storage unit locked
	64	NDE1861	Remote copy pair not in IN-HOLD status
	64	NDE1866	No remote link available
	64	NDE1890	CIMOM 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	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	NDE2021	No license for remote replication (ETERNUS DX/AF)
	130	NDE1082	Memory bottleneck during processing of command
	130	NDE2005	Command cannot be executed at the moment