MODIFY-REMOTE-COPY-PARAMETER Changes the processing mode and remote copy parameters

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


/MODIFY-REMOTE-COPY-PARAMETER enables the processing mode (COPY-MODE) to be modified, see the relevant section on "COPY-MODE (processing mode)". 

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.

MODIFY-REMOTE-COPY-PARAMETER

UNIT = *BY-VOLUME(...) / *BY-PUBSET(...) / *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-STORAGE(...)
		|	SERIAL-NUMBER = <alphanum-name 3..14>
		|	,LOGICAL-VOLUME = *ALL-SOURCE-UNITS(...) / <x-text 1..4>
		|			*ALL-SOURCE-UNITS(...)
		|				|	SELECT = *ANY / *ALL-DEFINED / *ATTACHED
,COPY-MODE = *UNCHANGED / *SYNCHRONOUS / *ASYNC-STACK / *ASYNCHRONOUS
,TARGET-UNIT = *UNIQUE / *ALL / *BY-STORAGE(...)
	*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-STORAGE), 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-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.

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

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.
Remote mirroring must be suspended (remote copy status IN-HOLD).

COPY-MODE = *ASYNCHRONOUS
Sets the processing mode to asynchronous processing (consistency mode in ETERNUS DX/AF).
Remote mirroring must be suspended (remote copy status IN-HOLD).

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

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-STORAGE(...)
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, NDE1071

• For unsuccessful processing NDE2007

Examples

/MODIFY-REMOTE-COPY-PARAMETER UNIT=*BY-PUBSET(PUBSET=RDF), 
      COPY-MODE=*SYNCH

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	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	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	NDE1171	Target unit is not unique
	64	NDE1191	Modified tracks in the target unit
	64	NDE1802	Error communicating with StorMan server
	64	NDE1803	Management instance not available
	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	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	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