SWAP-CLONE-SESSION Original- und Clone-Eigenschaft eines Clone-Paares vertauschen

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

Das Kommando /SWAP-CLONE-SESSION vertauscht bei Einsatz der Replikationsfunktion EC die Spiegeleigenschaften eines Clone-Paares. Vor Eingabe des Kommandos muss die Replikation unterbrochen sein (Clone-Session-Status SPLIT).

/SWAP-CLONE-SESSION vertauscht die Spiegeleigenschaften von einem oder von mehreren Clone-Paar(en), die aus je einer Original-Unit und einer Clone-Unit bestehen. Nach erfolgreicher Vertauschung sind die neue Original-Unit und die neue Clone-Unit weiterhin im Status SPLIT. Beide sind für Anwendungen vom Host aus zugreifbar. Aus Sicht der Anwendung enthält die Clone-Unit alle Daten der Original-Unit zum Zeitpunkt der Kommando-Verarbeitung.

Beim Operanden UNIT werden die Original-Units der Clone-Paare angegeben.

Bei der Auswahl der Original-Units über ein Pubset (UNIT=*BY-PUBSET) muss es zu allen Units des Pubsets Clone-Units geben. Das Clone-Pubset auf den Clone-Units kann mit dem Operanden RENAME-PUBSET direkt umbenannt werden, wenn es sich um einen SF-Pubset handelt.

/SWAP-CLONE-SESSION auf eine Unit, die gleichzeitig auch Source-Unit einer remote Replikation ist wird mit der Meldung NDE1177 abgewiesen.

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

SWAP-CLONE-SESSION

UNIT = *BY-VOLUME(...) / *BY-PUBSET(...) / *BY-STORAGE(...) / <alphanum-name 2..2> / <x-text 4..4>
	*BY-VOLUME(...)
		|	VOLUME = <vsn 1..6>
	*BY-PUBSET(...)
		|	PUBSET = <cat-id 1..4>
		|	,RENAME-PUBSET = *NO / *SAME / <cat-id 1..4>
	*BY-STORAGE(...)
		|	SERIAL-NUMBER = <alphanum-name 3..14>
		|	,LOGICAL-VOLUME = <x-text 1..4>
,CLONE-UNIT = *FIRST-POSSIBLE / *FROM-SHOW-OUTPUT(...) / *BY-PUBSET(...) /
				*BY-STORAGE(...) / list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
	*FROM-SHOW-OUTPUT(...)
		|	POSITION = *LAST / <integer 1..16>
	*BY-PUBSET(...)
		|	CLONE-PUBSET = <cat-id 1..4>
	*BY-STORAGE(...)
		|	CLONE-LOGICAL-VOLUME = <x-text 1..4>

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.

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 Units über eine Pubset-ID oder Volume-Set-ID. Der Pubset wird während der Kommandobearbeitung gegen Rekonfiguration gesperrt. Wenn ein SF-Pubset ausgewählt wird, können die Volumes des Clone-Pubsets mit RENAME-PUBSET umbenannt werden.

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

RENAME-PUBSET =
Bestimmt die Katalogkennung des Original-(SF-)Pubsets nach dem Vertauschen.

RENAME -PUBSET = *NO
Der Clone-Pubset wird nicht umbenannt, d.h. es behält den gleichen Namen.

RENAME-PUBSET = *SAME
Der Pubset wird nach dem Vertauschen auf die Pubset-ID oder Volume-Set-ID des ursprünglichen Original-Pubsets umbenannt (d.h. auf die bei PUBSET angegebene ID).

RENAME-PUBSET = <cat-id 1..4>
Explizite Angabe der neuen Pubset-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 = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.

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

CLONE-UNIT =
Auswahl der Clone-Unit. Wenn es zu einer Unit mehrere Clone-Units gibt, muss eine bestimmte Clone-Unit ausgewählt werden.

CLONE-UNIT = *FIRST-POSSIBLE
Auswahl der ersten möglichen Clone-Unit.

CLONE-UNIT = *FROM-SHOW-OUTPUT(...)
Auswahl der Clone-Unit über die Position in der Ausgabeliste von /SHOW-CLONE-SESSION-STATUS.

POSITION = *LAST
Auswahl der letzten Clone-Unit in der Ausgabeliste.

POSITION = <integer 1..16>
Angabe der Position der Clone-Unit.

CLONE-UNIT = *BY-PUBSET(...)
Auswahl der Clone-Unit über die Pubset-ID des aktivierten und umbenannten Pubsets.

CLONE-PUBSET = <cat-id 1..4>
Angabe der Pubset-ID.

CLONE-UNIT = *BY-STORAGE(...)
Auswahl der Clone Unit über die interne Nummer des logischen Volumes im Storage-System.

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

CLONE-UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Angabe des mnemotechnischen Gerätenamens des logischen Volumes.

Kommando-Verarbeitung

Folgende Meldungen werden pro Clone-Paar 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

Beispiele

/SWAP-CLONE-SESSION UNIT=*BY-PUBSET(PUBSET=CLON)

/SWAP-CLONE-SESSION UNIT=8300,CLONE-UNIT=3800

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
	1	CMD0202	Syntax-Fehler
	1	NDE1036	PUBSET und RENAME-PUBSET haben unterschiedliche Länge
	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	NDE1003	Gerät nicht zugeschaltet
	64	NDE1003	Datenträger nicht online oder nicht eindeutig
	64	NDE1004	Pubset nicht gefunden oder falscher Pubset-Typ
	64	NDE1005	Pubset nicht homogen
	64	NDE1008	Volume kann nicht allokiert werden
	64	NDE1015	Gerät in BS2000 nicht bekannt
	64	NDE1043	Pubset-Typ nicht unterstützt
	64	NDE1044	RENAME-PUBSET bereits vorhanden
	64	NDE1044	Umbenennen des Pubsets nicht möglich
	64	NDE1057	Funktion nicht unterstützt
	64	NDE1100	Ungültiger Pubset-Status
	64	NDE1101	Mehrfach genutzter Shared Pubset
	64	NDE1102	Nicht alle Volumes konnten belegt werden
	64	NDE1103	Kein Pubset-Rekonfigurations-Lock
	64	NDE1105	Inkonsistenter Pubset
	64	NDE1055	Funktion für Storage-System Symmetrix/VMAX3 nicht unterstützt
	64	NDE1143	Fehler bei Bearbeitung des Spiegelpaares
	64	NDE1177	Unit ist auch eine Source-Unit für Remote-Copy
	64	NDE1178	Gerät ist eine Target-Unit
	64	NDE1530	Keine Clone-Funktion für die Unit
	64	NDE1531	Unterschiedliche Geräteanzahl bei den Angaben Unit und Clone-Unit
	64	NDE1535	Gerät ist eine Clone-Unit
	64	NDE1540	Falscher Status der Unit
	64	NDE1541	Falscher Status der Clone-Unit
	64	NDE1549	Keine Clone-Unit zugeordnet für Clone-Unit Selektion
	64	NDE1553	Gerät ist keine Clone-Unit
	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	NDE1811	Funktion für Storage-System 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	NDE1853	Storage-Unit gesperrt
	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	NDE2020	Keine Lizenz für lokale Replikation (ETERNUS DX/AF)
	130	NDE1082	Speicherengpass während der Bearbeitung des Kommandos
	130	NDE2005	Kommando kann momentan nicht ausgeführt werden