Storage system: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Domain: | DEVICE |
Privileges: | TSOS |
/START-REMOTE-COPY
The source unit is selected using the UNIT operand.
The target unit is selected using the TARGET-UNIT operand. When a pubset is selected as UNIT, a list of MNs whose number matches the number of volumes in the pubset must be specified as the target unit.
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
For storage systems synchronization of the remote pairs is initiated immediately. The copy direction is always from the source unit to the target unit. You can wait for synchronization to be completed.
The following requirements must be satisfied before you enter /START-REMOTE-COPY:
The devices for source unit and target unit are of the same size and type.
- The devices for the target unit is bigger or of the same size as the source unit. If target unit ist bigger than source
/SWAP-REMOTE-COPYand/RESUME-REMOTE-COPYwithRESTORE=*TO-SOURCEis not possible. The remote links between the two storage systems are defined.
REC is licensed and configured in both storage systems (Copy Tables).
Synchronous and asynchronous replication is supported. Asynchronous replication is provided for ETERNUS DX/AF, see section "COPY-MODE (processing mode)".
Additional requirements must be fulfilled for asynchronous replication:
The source units and target units reside on ETERNUS DX/AF storage systems.
The ETERNUS DX/AF storage systems involved require REC buffers (cache) which are suitably dimensioned.
Concurrent remote copy is supported with up to 4 simultaneous target units in different storage systems for a source unit. Concurrent remote copy with target units in the same remote storage system is not supported.
In cascaded remote copy configurations a target unit is used as the source unit of another remote copy pair.
In concurrent and cascaded remote copy configurations synchronous and asynchronous replication can be combined.
The command is executed only for source units.
For SRDF on Symmetrix/VMAX3:
The following requirements must be satisfied before you enter /START-REMOTE-COPY:
The devices for
SOURCE-UNITandTARGET-UNITare configured in the sttorage system for dynamic use by SRDF (this condition is always satisfied for VMAX3)
are consistent.
The SRDF connections are defined via the local and the remote RA group.
Both synchronous and asynchronous SRDF pairs can be configured. When specifying the RA group of the source unit it must be ensured that the RA group selected matches the desired SRDF usage (SRDF/S or SRDF/A).
The START-SYNCHRONIZING operand can be used to select the time when synchronization of the newly created SRDF pair is to begin:
Synchronization can begin straight away (
*IMMEDIATE). In this case the copying direction (to the source unit or to the target unit) and the status of the target unit are also selected. You can wait for synchronization to be completed.Synchronization begins at a later time using the
RESUME-REMOTE-COPY(*AT-RESUME) command, e.g. in order to control the utilization of the SRDF link better. In this case the setting for the target unit can be predefined:READY(accessible for the server) orNOT-READYorREAD-ONLY(not accessible).
The concurrent SRDF function is supported by another SRDF connection being set up for a source unit parallel to an existing SRDF connection.
Target units can be larger than the source units.
Management of SRDF/A is always performed for an entire RA group. The entry UNIT=*BY-PUBSET is possible if the volumes of the pubset match the volumes of the RA group exactly.
Dynamic generation of SRDF/A pairs is supported.
An existing SRDF/A RA group can only be extended in the remote copy status IN-HOLD. As the new pair must also be in the IN-HOLD state and the target state when generating for individual asynchronous pairs cannot be changed, only *AT-RESUME(TARGET-ACCESS=*BY-SOURCE(TARGET-STATE=READ-ONLY)) is permitted for START-SYNCHRONIZING. The target state can then be changed for the entire RA group using SET-REMOTE-COPY-ACCESS.
The cascaded SRDF function enables an SRDF target unit to be used as the source unit of another SRDF pair.
In the case of cascaded SRDF pairs, the second pair may not be in the synchron processing mode. Furthermore, both pairs may not be asynchron.
START-REMOTE-COPY | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Selects the units by means of a particular catalog ID (*BY-PUBSET), via 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 mnemonic device name of the logical volume.
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 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 source 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 source unit by means of the mnemonic name of the logical volume.
TARGET-UNIT =
Selects the target units 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 mnemonic device name of the logical volume.
TARGET-UNIT = *BY-SYMMETRIX(...)
Only relevant for Symmetrix/VMAX3.
Selects the target unit by means of the serial number of the storage system and the internal number of the logical volume in the storage system.
TARGET-SERIAL-NUMBER = <alphanum-name 3..12>
Specifies the serial number of the storage system (make sure it is unique!).
TARGET-LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system
TARGET-UNIT = *BY-STORAGE(...)
Only relevant for ETERNUS DX/AF.
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!).
TARGET-LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system
TARGET-UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Selects the target units by means of the mnemonic device names of the logical volumes.
SOURCE-RA-GROUP =
Only relevant for Symmetrix/VMAX3.
Selects the SRDF connection used via the RA group.
SOURCE-RA-GROUP = *UNIQUE
The only unambiguous local RA group is used.
SOURCE-RA-GROUP = <integer 1..250>
The local RA group of the source unit(s) is specified.
START-SYNCHRONIZING =
Only relevant for Symmetrix/VMAX3.
Selects the time at which synchronization of the newly generated pair is to be started.
START-SYNCHRONIZING = *IMMEDIATE(...)
Synchronization is to be started immediately.
COPY-DIRECTION =
Selects the copy direction for synchronizing the newly generated pair.
COPY-DIRECTION = *FROM-SOURCE
Copying is to take place from the source unit to the target unit.
COPY-DIRECTION = *TO-SOURCE
Copying is to take place from the target unit to the source unit.
TARGET-STATE =
Specifies the state setting for the target units.
TARGET-STATE = *STD
The setting of the target units is specified in accordance with the generation in BS2000: To avoid ambiguous volume serial numbers in BS2000 operation, the NOT-READY state is set by default for generated target units. 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.
START-SYNCHRONIZING = *AT-RESUME(...)
Synchronization is to be started only when the /RESUME-REMOTE-COPY command is issued.
TARGET-ACCESS =
Accesses the new target units of the newly generated pair.
TARGET-ACCESS = *BY-SOURCE(...)
The target unit is to be accessed indirectly via the source units.
TARGET-STATE =
Specifies the state setting for the target units.
TARGET-STATE = *STD
The setting of the target units is specified in accordance with the generation in BS2000: To avoid ambiguous volume serial numbers in BS2000 operation, the NOT-READY state is set by default for generated target units. 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-ACCESS = *DIRECT
The target unit is to be accessed directly.
WAIT =
Specifies whether or not 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 for recovery; extensive queries regarding the synchronization progress are unnecessary.
Waiting can be aborted for Symmetrix/VMAX3 in dialog mode by hitting the K2 key.
May not be specified together with START-SYNCHRONIZING=*AT-RESUME.
COPY-MODE =
Defines the processing mode of remote copy mode, see the relevant section on "COPY-MODE (processing mode)" (ETERNUS DX/AF) or "COPY-MODE (processing mode)" (Symmetrix/VMAX3).
COPY-MODE = *SYNCHRONOUS
Sets the processing mode to synchronous processing.
This mode ensures that data was written to both the source and target unit after every successful write.
COPY-MODE = *ADAPTIVE-COPY(...)
Only relevant for Symmetrix/VMAX3.
Sets the processing mode to asynchronous processing. In this mode, performance improves during write load but remote copy reliability is reduced because the source and target units may differ by several writes.
WRITE-BUFFER =
Specifies whether pending writes are to be noted on the source unit or in the cache of the local storage system.
WRITE-BUFFER = *DISK
Pending writes are noted on the source unit. If the unprotected source unit fails, all data that has not yet been transferred is lost.
WRITE-BUFFER = *CACHE
Pending writes are noted in the cache of the local storage system. This reduces the cache storage space available for the read buffer. Performance may be impaired if a higher value has been specified for the PENDING-UPDATE-LIMIT operand.
The command is rejected with the message NDE1019 if the COPY-MODE=*ADAPTIVE-COPY(WRITE-BUFFER=*CACHE) operand is specified and the source unit resides on a VMAX3.
COPY-MODE = *ASYNCHRONOUS
Sets the processing mode to asynchronous processing (consistency mode for REC or SRDF/A).
Note for Symmetrix/VMAX3
After the new pair has been created, the target unit is in the READ-ONLY state. It can be placed in the NOT-READY state using the following command:
/SET-REMOTE-COPY-ACCESS UNIT=*BY-SYMMETRIX(SERIAL-NUMBER=..., LOGICAL-VOLUME=*ALL-SOURCE-UNITS(RA-GROUP=...)), TARGET-ACCESS=*BY-SOURCE(TARGET-STATE=*NOT-READY)
Note for SRDF/A
/START-REMOTE-COPY with COPY-MODE=*ASYNCHRONOUS is only possible under the following conditions:
The source RA group is in the remote copy status
IN-HOLDand in theASYNCHRONOUScopy mode.The following operand is specified.
START-SYNCHRONIZING=
*AT-RESUME(TARGET-ACCESS=*BY-SOURCE(TARGET-STATE=READ-ONLY))
Otherwise the command is rejected with NDE2012.
COPY-MODE = *ASYNC-STACK
Only relevant for ETERNUS DX/AF.
Sets the processing mode to asynchronous processing (asynchronous REC, stack mode).
FORCE =
Only relevant for Symmetrix/VMAX3.FORCE controls the start of a remote copy pair.
FORCE = *NO
The start of a remote copy pair is possibly be rejected with a message.
FORCE = *YES
The start of a remote copy pair is always executed.
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
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 | 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 | 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 | NDE1114 | Serial number not found | |
64 | NDE1115 | Serial number not unique | |
64 | NDE1116 | Storage system’s logical volume not found | |
64 | NDE1131 | RA group not found in the storage system | |
64 | NDE1140 | Duplicate MN in MN list | |
64 | NDE1141 | Source unit and target unit on storage systems of different types | |
64 | NDE1142 | Mirror pair already exists | |
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 | NDE1146 | Source unit(s) and target unit(s) have different metatype or size | |
64 | NDE1147 | Source unit(s) and target unit(s) are meta volumes with different stripe sizes | |
64 | NDE1148 | Different number of devices for source unit(s) and target unit(s) | |
64 | NDE1150 | No gatekeeper device found | |
64 | NDE1153 | Symmetrix device lock set | |
64 | NDE1154 | Disk belongs to a meta-disk | |
64 | NDE1155 | RAID10 devices not supported | |
64 | NDE1170 | Source unit with concurrent target units | |
64 | NDE1177 | Device is a source unit | |
64 | NDE1178 | Device is a target unit | |
64 | NDE1179 | Device is a cascaded target unit | |
64 | NDE1186 | Device has no or an incorrect dynamic SRDF property | |
64 | NDE1187 | RA group of the source unit is not unambiguous | |
64 | NDE1188 | RA group of the source unit not for the remote storage system | |
64 | NDE1189 | Target unit is not contained in the storage system selected via the local RA group | |
64 | NDE1534 | Device is a virtual unit | |
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 | 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 | NDE1841 | No connection between the storage systems | |
64 | NDE1842 | Configuration error in the REC buffer | |
64 | NDE1853 | Storage unit locked | |
64 | NDE1866 | No remote link available | |
64 | NDE1880 | Copy license not installed (ETERNUS DX/AF) | |
64 | NDE1881 | Copy Table Size not configured (ETERNUS DX/AF) | |
64 | NDE1882 | Copy Table Size too small (ETERNUS DX/AF) | |
64 | NDE1883 | Advanced Copy operations for devices locked (ETERNUS DX/AF) | |
64 | NDE1890 | Management instance not found | |
64 | NDE1893 | Source units on different storage systems | |
64 | NDE1867 | Number of replication cascades exceeded | |
64 | NDE1898 | Concurrent target units in the same storage system | |
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 | NDE2012 | Illegal parameter combination | |
64 | NDE2013 | SYMAPI error in command | |
64 | NDE2014 | StorMan error in command | |
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 |