SHC-OSD V15.0 (en)

&pagelevel(3)&pagelevel

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

/START-REMOTE-COPY creates one or more remote copy pairs by one device being assigned as the target unit and one as a source unit. Any device from another storage system of the same type can be used as the target unit.

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

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-COPY and /RESUME-REMOTE-COPY with RESTORE=*TO-SOURCE is 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.

START-REMOTE-COPY

UNIT = BY-PUBSET(...) / BY-STORAGE(...) /
			list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
	*BY-PUBSET(...)
		\|	PUBSET = <cat-id 1..4>
	*BY-STORAGE(...)
		\|	SERIAL-NUMBER = <alphanum-name 3..14>
		\|	,LOGICAL-VOLUME = <x-text 1..4>
,TARGET-UNIT =*BY-STORAGE(...) /
				list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
	*BY-STORAGE(...)
		\|	TARGET-SERIAL-NUMBER = <alphanum-name 3..14>
		\|	,TARGET-LOGICAL-VOL = <x-text 1..4>
,WAIT = NO / UNTIL-SYNCHRONIZATION
,COPY-MODE = SYNCHRONOUS / ASYNCHRONOUS / *ASYNC-STACK

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-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-STORAGE(...)
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-STORAGE), or directly by means of the mnemonic device name of the logical volume.

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

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.

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.

COPY-MODE =
Defines the processing mode of remote copy mode, see the relevant section on "COPY-MODE (processing mode)".

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 = *ASYNCHRONOUS
Sets the processing mode to asynchronous processing (consistency mode for REC).

COPY-MODE = *ASYNC-STACK
Sets the processing mode to asynchronous processing (asynchronous REC, stack mode).

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

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	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	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	NDE1148	Different number of devices for source unit(s) and target unit(s)
	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	NDE1534	Device is a virtual 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	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	NDE2012	Illegal parameter combination
	64	NDE2014	StorMan error in command
	130	NDE1082	Memory bottleneck during processing of command
	130	NDE2005	Command cannot be executed at the moment

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

START-REMOTE-COPY Creates a remote copy pair

For REC

Command processing

Command return codes