Storage system: | ETERNUS DX/AF |
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
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.
SWAP-REMOTE-COPY | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
If *BY-VOLUME, *BY-PUBSET is specified, the action is selected for the source unit automatically.
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-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.
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-UNIT =
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
NDE1073For 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 | 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 | |
64 | NDE1063 | Source unit does not have the state | |
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 | NDE1160 | Access to target unit of the remote copy pair is | |
64 | NDE1165 | Swap * | |
64 | NDE1170 | Source unit has concurrent target units | |
64 | NDE1179 | Device is a cascaded target unit | |
64 | NDE1193 | Command not allowed if target unit is larger than source unit | |
64 | NDE1535 | Device is a clone unit | |
64 | NDE1611 | Device is an SCO volume (ETERNUS DX/AF) | |
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 | NDE1842 | Configuration error in the REC buffer | |
64 | NDE1853 | Storage unit locked | |
64 | NDE1861 | Remote copy pair not in | |
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 |