Storage system: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Domain: | DEVICE |
Privileges: | TSOS |
enables the processing mode (
/MODIFY-REMOTE-COPY-PARAMETERCOPY-MODE) to be modified, see the relevant section on "COPY-MODE (processing mode)" (ETERNUS DX/AF) or "COPY-MODE (processing mode)" (Symmetrix/VMAX3). You change the remote copy parameters for Symmetrix/VMAX3 by means of the ON-ERROR operand. This controls whether applications are stopped if there is a device failure or whether operation continues with the remaining unit (see section "ON- ERROR").
The command is executed only for source units.
In concurrent remote copy configurations, synchronous processing mode can be combined with asynchronous processing mode (with or without data consistency).
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 ETERNUS DX/AF
The remote copy pair must have IN-HOLD status.
For Symmetrix/VMAX3
When changing in synchronous processing mode, WAIT=*UNTIL-SYNCHRONIZATION can be used in order to instruct the command to wait for synchronization to complete.
Changing to/from asynchronous processing mode (SRDF/A) is possible for a complete RA group only. This RA group must also have SRDF/A capability. The entry UNIT=*BY-PUBSET is possible if the volumes of the pubset match the volumes of the RA group exactly.
An RA group can also contain units not defined in BS2000.
A consistent switch from asynchronous (SRDF/A) to synchronous processing mode is supported by means of CONSISTENT=YES.
The ON-ERROR setting for concurrent remote copy configurations must be the same for both connections.
The CONSISTENCY-PROTECT operand enables you to specify how the storage system should react when data can no longer be copied from the source unit to the target unit in SRDF/A mode. Data consistency can be achieved for all data on the target units.
MODIFY-REMOTE-COPY-PARAMETER | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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), or directly by means of the logical volume's mnemonic device name.
If VOLUME or PUBSET is specified, the action is automatically performed for the correct unit (i.e. the source unit). A mnemonic name or the internal number of the logical volume in the storage system can only be specified for source units.
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-SYMMETRIX(...)
Only relevant for Symmetrix/VMAX3.
Selects the units by means of the serial number of the storage system and the internal number of the logical volume.
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 specified 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 = <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.
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.
COPY-MODE =
Modifies 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 = *UNCHANGED
The processing mode remains unchanged. The initial setting is made by customer support.
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.
For ETERNUS DX/AF: Remote mirroring must be suspended (remote copy status IN-HOLD).
WAIT =
Only relevant for Symmetrix/VMAX3.
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 because extensive queries regarding the synchronization progress of the remote copy pair are unnecessary.
Waiting can be aborted in dialog mode by hitting the K2 key.
CONSISTENT =
Specifies the transition from asynchronous to synchronous processing mode.
CONSISTENT = *NO
The transition from asynchronous to synchronous mode does not take place consistently.
CONSISTENT = *YES
The transition from asynchronous to synchronous mode takes place consistently.
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.
This entry must not be used together with ON-ERROR=*HOLD.
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 = *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.
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.
PENDING-UPDATE-LIMIT =
Specifies how many pending writes can be noted. If the maximum number of pending writes exceeds this limit, the processing mode is switched to semi-synchronous until the number falls below the limit.
PENDING-UPDATE-LIMIT = *UNCHANGED
Previous entry remains unchanged. The initial setting is made by customer support.
PENDING-UPDATE-LIMIT = <integer 1..65535>
Maximum number of pending write permitted.
COPY-MODE = *ASYNCHRONOUS
Sets the processing mode to asynchronous processing (consistency mode in ETERNUS DX/AF and SRDF/A in Symmetrix/VMAX3).
For ETERNUS DX/AF: Remote mirroring must be suspended (remote copy status IN-HOLD).
COPY-MODE = *ASYNC-STACK
Only relevant for ETERNUS DX/AF.
Sets the processing mode to asynchronous processing (asynchronous REC, stack mode).
ON-ERROR =
Only relevant for Symmetrix/VMAX3.
Specifies how the storage system is to respond if part of the remote copy pair is no longer available (in the event of the failure of the remote link, the source unit or the target unit).
The setting is always valid for both remote copy pairs with concurrent SRDF.
ON-ERROR = *UNCHANGED
Previous entry remains unchanged. The initial setting is made by customer support.
ON-ERROR = *HOLD
The storage system with the source units rejects all subsequent trquests; the applications are stopped and wait for a response. The source unit assumes the REMOUNT status. A decision can then be made (automatically or by the user) as to whether to continue with the source unit alone or to suspend operation in order to preserve data consistency.
This entry must not be specified for paging units because it may then be that no more SHC-OSD commands can be executed.
This entry must not be specified together with COPY-MODE=*ADAPTIVE-COPY or COPY-MODE=*ASYNCHRONOUS.
ON-ERROR = *CONTINUE
In the event of a failure, work continues with the remaining unit; the applications are not stopped. If the target unit fails, data loss occurs when a switch is later made to the target unit.
CONSISTENCY-PROTECT =
Only relevant for Symmetrix/VMAX3.
Specifies how the storage system is to react when data can no longer be copied from a source unit to the target unit in SRDF/A mode.CONSISTENCY-PROTECT can only be set for all devices of an RA group simultaneously.
CONSISTENCY-PROTECT = *UNCHANGED
The setting remains unchanged.
CONSISTENCY-PROTECT = *ENABLE
When data can no longer be copied from a source unit of an RA group to a target unit in SRDF/A mode, the connection to all devices of an RA group is interrupted. Consequently all data on the target unit remains consistent. To permit this, the copy mode must be ASYNCHRONOUS and the status ACTIVE.
CONSISTENCY-PROTECT = *DISABLE
When a remote copy pair of an RA group fails in SRDF/A mode, the target data becomes inconsistent.
TARGET-UNIT =
Controls selection of the target unit for concurrent remote copy.
TARGET-UNIT = *UNIQUE
Changes the processing mode for the one existing target unit.
TARGET-UNIT = *ALL
Changes the processing mode for all target units.
TARGET-UNIT = *BY-RA-GROUP(...)
Only relevant for Symmetrix/VMAX3.
Changes the processing mode for the target unit for the specified source RA group.
SOURCE-RA-GROUP = <integer 1..250>
Specifies the source RA group.
TARGET-UNIT = *BY-STORAGE(...)
Only relevant for ETERNUS DX/AF.
Changes the processing mode for the target unit of the specified storage system.
SERIAL-NUMBER = <alphanum-name 3..14>
Specifies the serial number of the storage system (make sure it is unique!).
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:
NDE1070,NDE1071For unsuccessful processing
NDE2007
Examples
/MODIFY-REMOTE-COPY-PARAMETER UNIT=*BY-PUBSET(PUBSET=RDF),
COPY-MODE=*SYNCH,ON-ERROR=*HOLD
/MODIFY-REMOTE-COPY-PARAMETER UNIT=5000,COPY-MODE=*ADAPTIVE-COPY(
WRITE-BUFFER=*CACHE,PENDING-UPDATE-LIMIT=44)
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 | NDE1010 | Enginuity version is not supported (too low) | |
64 | NDE1020 | No remote copy function for the specified unit | |
64 | NDE1021 | Device is not a source unit | |
64 | NDE1028 | Volume not unique in the unit | |
64 | NDE1077 | Combination of | |
64 | NDE1079 | None of the selected devices is attached | |
64 | NDE1081 | Synchronous command processing not possible | |
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 | NDE1114 | Serial number not found | |
64 | NDE1115 | Serial number not unique | |
64 | NDE1116 | Storage system’s logical volume not found | |
64 | NDE1153 | Symmetrix device lock set | |
64 | NDE1154 | Disk belongs to a meta-disk | |
64 | NDE1163 | Device is not SRDF/A-capable | |
64 | NDE1171 | Target unit is not unique | |
64 | NDE1172 | RA group invalid for the specified unit | |
64 | NDE1174 | Invalid combination for concurrent target units with | |
64 | NDE1190 | Command for | |
64 | NDE1191 | Modified tracks in the target unit | |
64 | NDE1196 | Combination of | |
64 | NDE1198 | Remote copy pair not in copy mode | |
64 | NDE1702 | Connection to SYMAPI server aborted | |
64 | NDE1811 | Function not supported for storage system | |
64 | NDE1812 | StorMan server switched off by command | |
64 | NDE1842 | Configuration error in the REC buffer | |
64 | NDE2000 | Execution partially successful | |
64 | NDE2001 | Command not executed | |
64 | NDE2009 | Command aborted with K2 key | |
64 | NDE2011 | Symmetrix license not entered | |
64 | NDE2013 | SYMAPI error in command | |
64 | NDE2017 | Command not possible for current status of the replication | |
64 | NDE2018 | Error on SYMAPI server during the current editing | |
130 | NDE1082 | Memory bottleneck during processing of command | |
130 | NDE2005 | Command cannot be executed at the moment |