STOP-CLONE-SESSION Clone-Paar auflösen

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

/STOP-CLONE-SESSION beendet eine Clone-Session und löst die Zuordnung eines Clone-Paares oder mehrerer Clone-Paare auf.

Durch die Ausführung des Kommandos bekommt die Clone-Unit wieder den Status eines normalen Gerätes ohne Clone-Funktion. Die Informationsfunktion für die Unit zeigt keine Clone-Nutzung mehr, nachdem die Verbindung zur letzten Clone-Unit aufgelöst wurde.

Bei der Auswahl der Original-Units über ein Pubset (UNIT=*BY-PUBSET) muss es zu allen Units des Pubsets Clone-Units geben.

Bei Beendigung der Clone-Session kann die Clone-Unit zerstört werden, wenn sie nicht weiter benötigt wird (ungültige VSN).

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 QuickOPC und EC auf ETERNUS DX/AF

Wenn die Clone-Session noch im Status SYNCHRONIZING ist, muss sie mit dem Operanden FORCE=*YES beendet werden.

Für TimeFinder/Clone auf Symmetrix/VMAX3

Die Clone-Session kann in einem beliebigem Status sein (siehe Abschnitt „Status der Clone-Session und der Geräte"). Wenn die Clone-Session im Status COPY-IN-PROGRESS ist, muss sie mit dem Operanden FORCE=*YES beendet werden.

STOP-CLONE-SESSION

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 = <x-text 1..4>
	*BY-STORAGE(...)
		|	SERIAL-NUMBER = <alphanum-name 3..14>
		|	,LOGICAL-VOLUME = <x-text 1..4>
,CLONE-UNIT = *FIRST-POSSIBLE / *FROM-SHOW-OUTPUT(...) / *ALL / *RESTORED /
				*BY-PUBSET(...) / *BY-SYMMETRIX(...) / *BY-STORAGE(...) /
				list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
	*FROM-SHOW-OUTPUT(...)
		|	POSITION = <integer 1..16> / *LAST
	*BY-PUBSET(...)
		|	CLONE-PUBSET = <cat-id 1..4>
	*BY-SYMMETRIX(...)
		|	CLONE-LOGICAL-VOLUME = <x-text 1..4>
	*BY-STORAGE(...)
		|	CLONE-LOGICAL-VOLUME = <x-text 1..4>
,CLONE-TYPE = *UNIQUE / *COPY / *MIRROR
,FORCE = *NO / *YES
,SELECT = *STD / *TARGET-UNIT(...)
	*TARGET-UNIT(...)
		|	RA-GROUP = *UNIQUE / <integer 1..250>
,CLONE-VSN = *KEEP / *DESTROY

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.

UNIT = *BY-VOLUME(...)
Auswahl der 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.

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

UNIT = *BY-SYMMETRIX(...)
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Unit ü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 = <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 Storage-Systems (Eindeutigkeit beachten!).

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

UNIT = list-poss(256): <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 für das Kommando 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 = <integer 1..16>
Angabe der Position der Clone-Unit.

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

CLONE-UNIT = *ALL
Auswahl aller Clone-Units.

CLONE-UNIT = *RESTORED
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Clone-Unit im Zustand *RESTORED.

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-SYMMETRIX(...)
Nur für Symmetrix/VMAX3 relevant.
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 = *BY-STORAGE(...)
Nur für ETERNUS DX/AF relevant.
Auswahl der Clone-Unit über die Seriennummer und 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.
Eine Liste wird nur akzeptiert, wenn beim Operanden UNIT ein Pubset angegeben wurde.

CLONE-TYPE=
Nur für ETERNUS DX/AF relevant.
Legt den Clone-Typ (und damit auch die Replikationsfunktion) fest, der verwendet wird.

CLONE-TYPE = *UNIQUE
Auswahl des Clone-Typ, der durch die explizite Auswahl bei CLONE-UNIT eindeutig bestimmt ist.

CLONE-TYPE = *COPY
Es wird der Clone-Typ COPY (und damit die Replikationsfunktion QuickOPC) ausgewählt.

CLONE-TYPE = *MIRROR
Es wird der Clone-Typ MIRROR (und damit die Replikationsfunktion EC) ausgewählt.

FORCE =
FORCE steuert das Beenden einer Clone-Session.

FORCE = *NO
Das Beenden einer Clone-Session im Status COPY-IN-PROGRESS / SYNCHRONIZING wird mit einer Meldung abgewiesen.

FORCE = *YES
Die Clone-Session wird unabhängig von ihrem Status beendet. Das Clone-Paar wird aufgelöst.

SELECT =
Auswahl der Clone-Paare.

SELECT = *STD
Auswahl der Clone-Paare, die mit dem Operanden UNIT festgelegt wurden.

SELECT = *TARGET-UNIT(...)
Auswahl der Clone-Paare, die der Target-Unit eines Remote-Copy-Paares zugeordnet sind. Beim Operanden UNIT wird die entsprechende Source-Unit angegeben.
Für ETERNUS DX/AF kann die Auswahl nur erfolgen, wenn die Target-Unit eindeutig ist. Concurrent Remote-Copy wird hier nicht unterstützt.

RA-GROUP =
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Target-Unit über die RA-Gruppe bei Concurrent Target-Units.

RA-GROUP = *UNIQUE
Die einzige existierende Target-Unit wird ausgewählt.

RA-GROUP = <integer 1..250>
Angabe der RA-Gruppe zur Auswahl der Target-Unit.

CLONE-VSN =
Steuert die Behandlung der VSN auf der Clone-Unit nach Beendigung der Clone-Session. Dies ist nur für zugeschaltete BS2000-Geräte möglich.

CLONE -VSN = *KEEP
Die VSN auf der Clone-Unit bleibt unverändert.

CLONE -VSN = *DESTROY
Die VSN auf der Clone-Unit wird gelöscht. Damit kann diese in BS2000 nicht mehr genutzt werden.

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

/STOP-CLONE-SESSION UNIT=5000,CLONE-UNIT=*ALL

/STOP-CLONE-SESSION UNIT=*BY-PUBSET(PUBSET=TFC)

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
	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	NDE1003	Datenträger nicht online oder nicht eindeutig
	64	NDE1004	Pubset nicht gefunden oder falscher Pubset-Typ
	64	NDE1005	Pubset nicht homogen
	64	NDE1006	Pubset/Volume ist allokiert
	64	NDE1008	Volume kann nicht allokiert werden
	64	NDE1010	Enginuity-Stand wird nicht unterstützt (zu niedrig)
	64	NDE1015	Gerät in BS2000 nicht bekannt
	64	NDE1043	Pubset-Typ nicht unterstützt
	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	NDE1108	SELECT=*TARGET-UNIT: UNIT ist keine Source-Unit
	64	NDE1109	SELECT=*TARGET-UNIT: TARGET-UNIT nicht gefunden
	64	NDE1114	Seriennummer nicht gefunden
	64	NDE1115	Seriennummer nicht eindeutig
	64	NDE1116	Logical Volume im Storage-System nicht gefunden
	64	NDE1143	Fehler bei Bearbeitung des Spiegelpaares
	64	NDE1150	Kein Gatekeeper-Gerät gefunden
	64	NDE1153	Symmetrix Device-Lock gesetzt
	64	NDE1154	Platte gehört zu einer Meta-Platte
	64	NDE1171	RA-Gruppe nicht eindeutig
	64	NDE1172	RA-Gruppe für die angegebene Unit ungültig
	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	NDE1548	Clone-Typ kann nicht eindeutig bestimmt werden
	64	NDE1549	Keine Clone-Unit zugeordnet für Clone-Unit Selektion
	64	NDE1553	Gerät ist keine Clone-Unit
	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	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	NDE1897	Kommandoausführung nur mit FORCE=*YES
	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	NDE2009	Kommandobearbeitung mit K2-Taste abgebrochen
	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	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