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

Storage-System:	ETERNUS DX/AF
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

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.

SWAP-REMOTE-COPY

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
,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-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 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-STORAGE(...)
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-UNIT =
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	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	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	NDE1160	Zugriff auf Target-Unit des Remote-Copy-Paares ist BY-SOURCE
	64	NDE1165	Swap *RESTORE-TO-SOURCE im Secure-Modus nicht möglich
	64	NDE1170	Source-Unit hat Concurrent Target-Units
	64	NDE1179	Gerät ist eine kaskadierte Target-Unit
	64	NDE1193	Kommando nicht erlaubt wenn Target-Unit größer als Source-Unit
	64	NDE1535	Gerät ist eine Clone-Unit
	64	NDE1611	Gerät ist ein SCO-Volume (ETERNUS DX/AF)
	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	NDE2014	StorMan-Fehler in Kommando
	64	NDE2017	Kommando im aktuellen Status der Replikation nicht möglich
	130	NDE1082	Speicherengpass während der Bearbeitung des Kommandos
	130	NDE2005	Kommando kann momentan nicht ausgeführt werden