SWAP-REMOTE-COPY Source- und Target-Eigenschaft eines Remote-Copy-Paares vertauschen

Storage-System:	ETERNUS DX/AF, Symmetrix/VMAX3
Anwendungsbereich:	DEVICE
Privilegierung:	TSOS

Das Kommando /SWAP-REMOTE-COPY vertauscht die Source- und die Target-Eigenschaft eines Remote-Copy-Paares.
Es kann verwendet werden, um nach einem Failover die Target-Unit zur Source-Unit zu machen und auf dieser mit derselben Ausfallsicherheit wie zuvor weiterzuarbeiten.
Es kann nicht in Konfigurationen mit Concurrent Remote-Copy verwendet werden.Source- und Target-Unit müssen gleich groß sein.

Vor der Ausführung dieses Kommandos überprüft SHC-OSD die globalen und Task-spezifischen Sicherheitseinstellungen (siehe "Sicherheitseinstellungen von SHC-OSD"). Die aktuellen Sicherheitseinstellungen können mit /SHOW-SHC-PROCESSING angezeigt werden (siehe "SHOW-SHC-PROCESSING Einstellungen von SHC-OSD anzeigen"). Sie können in der SHC-OSD-Parameterdatei (siehe "Konfiguration von SHC-OSD") für den nächsten Start von SHC-OSD oder mit /MODIFY-SHC-PROCESSING für den laufenden Betrieb geändert werden (siehe "MODIFY-SHC-PROCESSING Einstellungen von SHC-OSD ändern").

Für REC auf ETERNUS DX/AF

Vor Eingabe des Kommandos muss der Remote-Copy-Betrieb unterbrochen sein (Remote-Copy-Status IN-HOLD oder ERROR). Im Falle eines Ausfalls wird er typischerweise unterbrochen sein (Remote-Copy-Status ERROR). Das Kommando kann im synchronen und in den asynchronen Betriebsmodus eingegeben werden.

Nach erfolgreicher Ausführung des Kommandos erfolgt keine automatische Re-Synchronisation des neuen Source-Target-Paares.

Der Operand TARGET-UNIT steuert beim Wechsel von Cascaded-Remote-Copy zu Concurrent-Remote-Copy oder umgekehrt die Auswahl der Target-Unit.

Für SRDF auf Symmetrix/VMAX3

Vor Eingabe des Kommandos muss der Remote-Copy-Betrieb unterbrochen und der direkte Zugriff auf die Target-Unit freigeschaltet sein (Remote-Copy-Status IN-HOLD und Target-Access DIRECT).

Beim SRDF-Swap müssen die Source-Unit und die Target-Unit die dynamische SRDF-Fähigkeit besitzen. Die dynamische SRDF-Fähigkeit von Units kann mit /SHOW-SYMMETRIX-DEVICE-CONFIG angezeigt werden.

Beim Vertauschen von Source- und Target-Unit darf Concurrent-Remote-Copy nicht im Einsatz sein, d.h. die Source-Unit darf nur eine Target-Unit besitzen. 

SWAP-REMOTE-COPY

UNIT = *BY-VOLUME(...) / *BY-PUBSET(...) / *BY-SYMMETRIX(...) /
			*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-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>
	*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
,TARGET-STATE = *STD / *NOT-READY / *READ-ONLY
,TARGET-UNIT = *UNIQUE / *BY-STORAGE(...) / <alphanum-name 2..2> / <x-text 4..4>
	*BY-STORAGE(...)
		|	TARGET-SERIAL-NUMBER = <alphanum-name 3..14>

UNIT =
Auswahl der Units über eine bestimmte Archivnummer (*BY-VOLUME), eine bestimmte Katalogkennung (*BY-PUBSET), über die Seriennummer und die interne Nummer des logischen Volumes im Storage-System (*BY-SYMMETRIX/*BY-STORAGE) oder direkt über den mnemotechnischen Gerätenamen des logischen Volumes.

Wenn *BY-VOLUME oder *BY-PUBSET angegeben wird, dann wird die Aktion automatisch für die Source-Unit ausgewählt. Wenn ein mnemotechnischer Name oder *BY-SYMMETRIX angegeben wird, sind Source- oder Target-Units zulässig.

UNIT = *BY-VOLUME(...)
Auswahl der Source-Units über eine bestimmte Archivnummer.

VOLUME = <vsn 1..6>
Angabe der Archivnummer des Volumes.

UNIT = *BY-PUBSET(...)
Auswahl der Source-Units über eine Pubset-ID oder Volume-Set-ID. Der Pubset wird während der Kommandobearbeitung gegen Rekonfiguration gesperrt.

PUBSET = <cat-id 1..4>
Angabe der Pubset-ID oder Volume-Set-ID.

UNIT = *BY-SYMMETRIX(...)
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Source- oder Target-Units über die Seriennummer des Storage-Systems und die interne Nummer des logischen Volumes im Storage-System.

SERIAL-NUMBER = <alphanum-name 3..12>
Angabe der Seriennummer des Storage-Systems (Eindeutigkeit beachten!).

LOGICAL-VOLUME = *ALL-SOURCE-UNITS(...)
Die Source-Units des Storage-Systems werden ausgewählt.

SELECT = *ANY
Alle Source-Units des angegebenen Storage-Systems werden ausgewählt.

SELECT = *ALL-DEFINED
Alle in BS2000 generierten Source-Units des angegebenen Storage-Systems werden ausgewählt.

SELECT = *ATTACHED
Alle in BS2000 zugeschalteten Source-Units des angegebenen Storage-Systems werden ausgewählt.

RA-GROUP = *ANY
Alle RA-Gruppen werden ausgewählt.

RA-GROUP = <integer 1..250>
Alle Source-Units einer RA-Gruppe werden ausgewählt.

LOGICAL-VOLUME = *ALL-TARGET-UNITS(...)
Die Target-Units des Storage-Systems werden ausgewählt.

SELECT = *ANY
Alle Target-Units des angegebenen Storage-Systems werden ausgewählt.

SELECT = *ALL-DEFINED
Alle in BS2000 generierten Target-Units des angegebenen Storage-Systems werden ausgewählt.

SELECT = *ATTACHED
Alle in BS2000 zugeschalteten Target-Units des angegebenen Storage-Systems werden ausgewählt.

RA-GROUP = *ANY
Alle RA-Gruppen werden ausgewählt.

RA-GROUP = <integer 1..250>
Alle Target-Units einer RA-Gruppe werden ausgewählt.

LOGICAL-VOLUME = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.

UNIT = *BY-STORAGE(...)
Nur für ETERNUS DX/AF relevant.
Auswahl der Unit über die Seriennummer und die interne Nummer des logischen Volumes im Storage-System.

SERIAL-NUMBER = <alphanum-name 3..14>
Angabe der Seriennummer des Storage-Systems (Eindeutigkeit beachten!).

LOGICAL-VOLUME = *ALL-SOURCE-UNITS(...)
Die Source-Units des Storage-Systems werden ausgewählt.

SELECT = *ANY
Alle Source-Units des angegebenen Storage-Systems werden ausgewählt.

SELECT = *ALL-DEFINED
Alle in BS2000 generierten Source-Units des angegebenen Storage-Systems werden ausgewählt.

SELECT = *ATTACHED
Alle in BS2000 zugeschalteten Source-Units des angegebenen Storage-Systems werden ausgewählt.

UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Auswahl der Unit über den mnemotechnischen Gerätenamen des logischen Volumes.

TARGET-STATE =
Nur für Symmetrix/VMAX3 relevant.
Bestimmt die Einstellung des Status für die Target-Units.

TARGET-STATE = *STD
Die Einstellung der Target-Units erfolgt abhängig von der Generierung in BS2000. Um im BS2000-Betrieb mehrdeutige Archivnummern zu vermeiden, wird für generierte Target-Units als Standard der Zustand NOT-READY eingestellt. Für alle anderen Target-Units, z.B. die aller Nicht-BS2000-Systeme, wird der Zustand READ-ONLY eingestellt.

TARGET-STATE = *NOT-READY
Für alle Target-Units wird der Zustand NOT-READY eingestellt.

TARGET-STATE = *READ-ONLY
Für alle Target-Units wird der Zustand READ-ONLY eingestellt.

TARGET-UNIT =
Nur für ETERNUS DX/AF relevant.
Steuert beim Wechsel von Cascaded-Remote-Copy zu Concurrent-Remote-Copy oder umgekehrt die Auswahl der Target-Unit.

TARGET-UNIT = *UNIQUE
Der Remote-Copy-Betrieb wird für die einzige existierende Target-Unit aufgenommen.

TARGET-UNIT = *BY-STORAGE(...)
Auswahl der Target-Unit über die Seriennummer im Storage-System.

TARGET-SERIAL-NUMBER = <alphanum-name 3..14>
Angabe der Seriennummer des Storage-Systems (Eindeutigkeit beachten!) mit der Target-Unit.

Kommando-Verarbeitung

Folgende Meldungen werden pro Gerät nach SYSOUT ausgegeben und über Routing-Code 0 verteilt, d.h. sie werden nur in der CONSLOG-Datei protokolliert. Detaillierte Informationen zur CONSLOG-Datei (Protokolldatei) finden Sie im Handbuch „Systembetreuung“ [5].

• Für erfolgreiche Bearbeitung: NDE1073

• Für nicht-erfolgreiche Bearbeitung: NDE2007

Beispiel

/SWAP-REMOTE-COPY UNIT=*BY-PUBSET(PUBSET=RDF)

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Kommando erfolgreich ausgeführt
1	0	NDE2003	Kommando erfolgreich ausgeführt, keine Bearbeitung notwendig
2	0	NDE2004	Kommando erfolgreich ausgeführt, aber noch nicht beendet
3	0	NDE1067	Remote-Copy-Paar noch nicht synchron
3	0	NDE1069	Erfolgreiche Ausführung, Daten einiger Units noch nicht aktualisiert
	1	CMD0202	Syntax-Fehler
	32	NDE2002	Interner Fehler
	64	CMD0087	Funktion im aktuellen Eingabe-Modus oder mit den aktuellen Task-Privilegien nicht erlaubt
	64	CMD0216	Erforderliches Privileg nicht vorhanden
	64	NDE1000	Gerät nicht gefunden oder nicht im Storage-System
	64	NDE1001	Gerät nicht zugeschaltet
	64	NDE1002	Steuerung nicht gefunden
	64	NDE1003	Datenträger nicht online oder nicht eindeutig
	64	NDE1004	Pubset nicht gefunden oder falscher Pubset-Typ
	64	NDE1005	Pubset nicht homogen
	64	NDE1010	Enginuity-Stand wird nicht unterstützt (zu niedrig)
	64	NDE1015	Gerät in BS2000 nicht bekannt
	64	NDE1020	Keine Remote-Copy-Funktion für die angegebene Unit
	64	NDE1028	Datenträger in der Unit nicht eindeutig
	64	NDE1061	Remote-Copy-Status ist nicht IN-HOLD
	64	NDE1063	Source-Unit nicht im Status READY
	64	NDE1066	Kein Remote-Link-Director verfügbar
	64	NDE1079	Keines der ausgewählten Geräte ist zugeschaltet
	64	NDE1100	Ungültiger Pubset-Status
	64	NDE1102	Nicht alle Volumes konnten belegt werden
	64	NDE1103	Kein Pubset-Rekonfigurations-Lock
	64	NDE1105	Inkonsistenter Pubset
	64	NDE1107	Keine Belegung des Pubsets möglich
	64	NDE1114	Seriennummer nicht gefunden
	64	NDE1115	Seriennummer nicht eindeutig
	64	NDE1116	Logical Volume im Storage-System nicht gefunden
	64	NDE1150	Kein Gatekeeper-Gerät gefunden
	64	NDE1153	Symmetrix Device-Lock gesetzt
	64	NDE1154	Platte gehört zu einer Meta-Platte
	64	NDE1160	Zugriff auf Target-Unit des Remote-Copy-Paares ist BY-SOURCE
	64	NDE1162	Swap nicht möglich
	64	NDE1164	Konflikt zwischen RESUME-PARAMETER und Pending-Updates
	64	NDE1165	Swap *RESTORE-TO-SOURCE im Secure-Modus nicht möglich
	64	NDE1166	Swap mit RESUME-PAR=*ANY nicht möglich falls statischer Swap
	64	NDE1167	Configuration Session Lock ist gesetzt
	64	NDE1168	Fehler während Konfigurationsänderung
	64	NDE1170	Source-Unit hat Concurrent Target-Units
	64	NDE1179	Gerät ist eine kaskadierte Target-Unit
	64	NDE1190	Kommando für COPY-MODE=*ASYNCHRON nur für ganze RA-Gruppe
	64	NDE1193	Kommando nicht erlaubt wenn Target-Unit größer als Source-Unit
	64	NDE1194	Kommando nicht erlaubt wenn SRDF Farpoint im Einsatz
	64	NDE1535	Gerät ist eine Clone-Unit
	64	NDE1611	Gerät ist ein SCO-Volume (ETERNUS DX/AF)
	64	NDE1702	Verbindung zu SYMAPI-Server abgebrochen
	64	NDE1800	Gerät nicht gefunden oder nicht in Storage-System
	64	NDE1802	Kommunikationsfehler zum StorMan-Server
	64	NDE1803	Management Instance nicht verfügbar
	64	NDE1810	Betriebssystem-Version des Storage-Systems nicht unterstützt
	64	NDE1812	StorMan-Server per Kommando abgeschaltet
	64	NDE1814	Seriennummer des Storage-Systems nicht gefunden
	64	NDE1815	Seriennummer des Storage-Systems nicht eindeutig
	64	NDE1816	Logical Volume des Storage-Systems nicht gefunden
	64	NDE1833	kein passender StorMan-Server gefunden
	64	NDE1842	Konfigurationsfehler im REC-Puffer
	64	NDE1853	Storage-Unit gesperrt
	64	NDE1861	Remote-Copy-Paar nicht in Status IN-HOLD
	64	NDE1866	Keine Remote-Verbindung verfügbar
	64	NDE1890	Management Instance nicht gefunden
	64	NDE1899	Kommando für aktuellen Status des Spiegelpaares nicht möglich
	64	NDE2000	Teilweise erfolgreiche Ausführung
	64	NDE2001	Kommando nicht ausgeführt
	64	NDE2011	Keine Symmetrix-Lizenz eingetragen
	64	NDE2013	SYMAPI-Fehler in Kommando
	64	NDE2014	StorMan-Fehler in Kommando
	64	NDE2017	Kommando im aktuellen Status der Replikation nicht möglich
	64	NDE2018	Fehler im SYMAPI-Server während der aktuellen Bearbeitung
	64	NDE2021	Keine Lizenz für remote Replikation (ETERNUS DX/AF)
	130	NDE1082	Speicherengpass während der Bearbeitung des Kommandos
	130	NDE2005	Kommando kann momentan nicht ausgeführt werden