SET-REMOTE-COPY-ACCESS Sets the access path to the data of a remote copy pair

Storage system:	Symmetrix/VMAX3
Domain:	DEVICE
Privileges:	TSOS


/SET-REMOTE-COPY-ACCESS changes the access path to the data of a remote copy pair (access via the source path or target path).

The data of the remote copy pair is normally accessed via the source path (i.e. the target unit can only be accessed internally via the remote link).

If either the storage system with the source units or the entire local Data Center fails, the data can be accessed directly via the target path. This is done by entering the command with TARGET-ACCESS=*DIRECT.

The command is rejected if the remote copy pair has the remote copy state ACTIVE.

Controlling remote copy pairs in asynchronous processing mode (SRDF/A) is possible for an entire RA group only. 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.

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

SET-REMOTE-COPY-ACCESS

UNIT = *BY-VOLUME(...) / *BY-PUBSET(...) / *BY-SYMMETRIX(...) /
			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-SYMMETRIX(...)
		|	SERIAL-NUMBER = <alphanum-name 3..12>
		|	,LOGICAL-VOLUME = *ALL-SOURCE-UNITS(...) / *ALL-TARGET-UNITS(...) / <x-text 1..4>
		|		*ALL-SOURCE-UNITS(...)
		|			|	SELECT = *ANY / *ALL-DEFINED / *ATTACHED
		|			|	,RA-GROUP = *ANY / <integer 1..250>
		|		*ALL-TARGET-UNITS(...)
		|			|	SELECT = *ANY / *ALL-DEFINED / *ATTACHED
		|			|	,RA-GROUP = *ANY / <integer 1..250>
,TARGET-ACCESS = *BY-SOURCE(....) / *DIRECT(...)
	*BY-SOURCE(...)
		|	TARGET-STATE = *STD / *NOT-READY / *READ-ONLY
	*DIRECT(...)
		|	ALLOW-PEND-UPDATES = *NO / *YES
,TARGET-UNIT = *UNIQUE / *ALL / *BY-RA-GROUP(...)
	*BY-RA-GROUP(...)
		|	SOURCE-RA-GROUP = <integer 1..250>

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.

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(...)
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 = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system.

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.

RA-GROUP = *ANY
Selects all RA groups.

RA-GROUP = <integer 1..250>
Selects all source units of an RA group.

LOGICAL-VOLUME = *ALL-TARGET-UNITS(...)
Selects the target units of the storage system.

SELECT = *ANY
Selects all target units of the specified storage system.

SELECT = *ALL-DEFINED
Selects all target units (generated in BS2000) of the specified storage system.

SELECT = *ATTACHED
Selects all target units (attached in BS2000) of the specified storage system.

RA-GROUP = *ANY
Selects all RA groups.

RA-GROUP = <integer 1..250>
Selects all target units of an RA group.

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-ACCESS =
Specifies the access path to the data of a remote copy pair.

TARGET-ACCESS = *BY-SOURCE(...)
The data of the remote copy pair is accessed via the source path (i.e. the source unit is addressed).
This is the normal access path for the remote copy pair or when remote copy mode is to be resumed after a failure.
The target units are not addressed in this state. The NOT-READY state is set by default for generated target units to prevent ambiguous VSNs in BS2000 operation. The READ-ONLY state is set for all other target units, e.g. all target units of non-BS2000 systems.

TARGET-STATE =
Specifies the state setting for the target units.

TARGET-STATE = *STD
The target unit setting depends on generation in BS2000 as described in TARGET-ACCESS=*BY-SOURCE(...).

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 data of the remote copy pair is accessed directly (i.e. the target unit is addressed).
This access path is set if either the storage system with the source units or the local Data Center fails and operation is to continue with the target unit until the problem is resolved. What happens then depends on whether or not the internal PEND-UPD=NOT-ALLOWED or ALLOWED setting is overridden.

ALLOW-PEND-UPDATES =
Specifies how the PEND-UPD=NOT-ALLOWED setting is to be handled. This setting prevents inadvertent use of invalid data if the target unit is no longer synchronized.

ALLOW-PEND-UPDATES = *NO
The PEND-UPD=NOT-ALLOWED setting is not overridden. The target unit rejects the transition to READY and is given the DISABLED state if pending writes are still noted on the target unit.

ALLOW-PEND-UPDATES = *YES
The PEND-UPD=NOT-ALLOWED setting is overridden. The target unit is given the READY state even if pending writes are still noted. This can result in data inconsistencies.

TARGET-UNIT =
Controls selection of the target unit for concurrent remote copy.

TARGET-UNIT = *UNIQUE
Remote copy mode is changed for the one existing target unit.

TARGET-UNIT = *ALL
Remote copy mode is changed for all target units.

TARGET-UNIT = *BY-RA-GROUP(...)
Remote copy mode is changed for the target unit of the specified source RA group.

SOURCE-RA-GROUP = <integer 1..250>
Specifies the source RA group

Command processing

The following messages are output to SYSOUT for each remote copy pair 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: NDE1072

• For unsuccessful processing NDE2007

Examples

/SET-REMOTE-COPY-ACCESS UNIT=*BY-PUBSET(PUBSET=RDF),TARGET-ACCESS=*DIRECT

/SET-REMOTE-COPY-ACCESS UNIT=*BY-VOLUME(VOLUME=RDF.00),TARGET-ACCESS=*BY-SOURCE

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	NDE1025	Direct access to the source unit not possible
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	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	NDE1026	Direct access to the target unit not possible
	64	NDE1027	Remote copy state is ACTIVE
	64	NDE1028	Volume not unique in the unit
	64	NDE1029	Target unit in the state DISABLED
	64	NDE1065	ON-ERROR=*HOLD
	64	NDE1078	TARGET-ACCESS=*BY-SOURCE not permitted when paging is active on the target unit
	64	NDE1079	None of the selected devices is attached
	64	NDE1094	TARGET-ACCESS=*BY-SOURCE not allowed, if source unit is in state DISABLED and ON-ERROR=*HOLD
	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	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	NDE1171	Target unit is not unique
	64	NDE1172	RA group invalid for the specified unit
	64	NDE1190	Command in COPY-MODE=*ASYNCHRONOUS only supported for entire RA group
	64	NDE1702	Connection to SYMAPI server aborted
	64	NDE2000	Execution partially successful
	64	NDE2001	Command not executed
	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