Storage-System: | ETERNUS DX/AF |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
/START-CLONE-SESSION erstellt ein oder mehrere Clone-Paar(e), indem je ein Gerät als Clone-Unit einer Original-Unit zugeordnet wird. Als Clone-Unit kann ein beliebiges Gerät verwendet werden. Dabei müssen die Geräte für Unit und Clone-Unit in demselben Storage-System sein und den gleichen Typ haben.
Clone-Units können kaskadiert werden, d.h. eine Clone-Unit kann gleichzeitig Original-Unit eines weiteren Clone-Paares sein.
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. Der Clone-Pubset auf den Clone-Units kann mit QuickOPC mit dem Operanden NEW-PUBSET direkt umbenannt werden, wenn es sich um einen SF-Pubset handelt.
Mit einem Kommando /START-CLONE-SESSION können Clone-Units für alle Units eines Pubsets erzeugt werden. In diesem Fall wird bei UNIT der Pubset ausgewählt. Bei CLONE-UNIT wird eine Liste von Geräten angegeben, die alle noch nicht als Clone-Units genutzt werden und deren Anzahl mit der Anzahl der Units des Pubsets übereinstimmt.
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
Durch die Ausführung des Kommandos wird die Synchronisation des Clone-Paares implizit gestartet. Die Clone-Unit ist direkt nach der Kommadoausführung für den Host zugreifbar. Das Clone-Paar wird im Hintergrund synchronisiert. Es bekommt den Status SYNCHRONIZING. Nach Abschluss der Synchronisation erhält das Clone-Paar automatisch den Status SPLIT.
QuickOPC Clone-Units können größer sein als die Original-Unit. Für solche Paare ist aber kein /RESTORE-FROM-CLONE möglich.
Die Maximalzahl aller Spiegel pro Unit im Storage-System beträgt 32.
Ein Auflösen der Paarverbindung mit /STOP-CLONE ist erst im Zustand SPLIT möglich.
Für EC
Durch die Ausführung des Kommandos wird die Synchronisation des Clone-Paares implizit gestartet, das Clone-Paar bekommt den Status SYNCHRONIZING. Nach Beendigung der erstmaligen Synchronisation ist das Paar im Status SYNCHRONIZED.
Die Clone-Unit ist nach der Kommandoausführung für den Host nicht zugreifbar.
Die Clone-Unit kann anschließend mit /ACTIVATE-CLONE aktiviert werden, wodurch sie für den Host zugreifbar wird. Dies ist nur im Status SYNCHRONIZED möglich.
Die Maximalzahl aller Spiegel pro Unit im Storage-System beträgt 32.
Ein Auflösen der Paarverbindung mit /STOP-CLONE ist erst im Zustand SYNCHRONIZED möglich.
START-CLONE-SESSION | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Auswahl der Units über 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-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.
NEW-PUBSET =
Nur für QuickOPC relevant.
Bestimmt die Katalogkennung des Clone-Pubsets der Clone-Units.
NEW-PUBSET = *SAME
Der Clone-Pubset wird nicht umbenannt, d.h. es behält den gleichen Namen.
NEW-PUBSET = *SPECIAL-VSN
Alle Volumes der Clone-Units werden automatisch umbenannt, damit eine Mehrdeutigkeit mit dem Original vermieden wird. Dazu wird in einer VSN in Punkt-Notation der Punkt in einen Doppelpunkt (z.B. AA.001 in AA:001) bzw. bei PUB-Notation die Zeichenfolge PUB in P:B geändert (z.B. PUBA01 in P:BA01).
NEW-PUBSET = <cat-id 1..4>
Der Clone-Pubset eines SF-Pubsets wird umbenannt, indem die neue Katalogkennung explizit angegeben wird. Die Katalogkennung kann auch eine unterschiedliche Länge im Vergleich zum Operanden PUBSET haben. Der neue Clone-Pubset wird ebenfalls ein SF-Pubset. Es wird ein existierender MRSCAT-Eintrag verwendet, wenn er den richtigen Typ hat. Anderenfalls wird der Eintrag gelöscht und neu erstellt. Siehe die Hinweise im Abschnitt „Umbenennen von SF-Pubsets mit SHC-OSD".
HOLD-IO =
Nur für QuickOPC relevant.
Behandlung von Ein-/Ausgaben auf das Clone-Paar während der Auftrennung (siehe „Konsistente Abtrennung eines Pubsets auch im Shared-Pubset-Verbund" (Konsistenzpunkt für Replikationen)).
HOLD-IO = *NO
Die Ein-/Ausgaben auf die Original-Units werden unverändert ausgeführt. Dies kann auf den Clone-Units zu Dateninkonsistenz führen für Anwendungen, die vor der Auftrennung nicht angehalten werden.
HOLD-IO = *UNTIL-ACTIVATED
Die Ein-/Ausgaben auf die Original-Units werden angehalten, bis alle Clone-Paare des importierten Pubsets im Zustand COPY-ON-WRITE sind. Danach werden die Ein-/Ausgaben auf die Units wieder aufgenommen. Wenn beim Anhalten oder Wiederaufnehmen der Ein-/Ausgaben ein Fehler auftritt, wird das Kommando abgebrochen. Gegebenenfalls muss die Ein-/Ausgabe-Aktivität mit /RESUME-IO wieder aufgenommen werden.
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 (dabei ist die Eindeutigkeit der Nummer zu 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 des Geräts für die Clone-Unit über den mnemotechnischen Gerätenamen des logischen Volumes oder über seine interne Nummer im Storage-System.
CLONE-UNIT = *BY-STORAGE(...)
Auswahl der Clone-Unit über die interne Nummer des logischen Volumes im Storage-System.
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 Unit-Liste wird nur akzeptiert, wenn beim Operanden UNIT ein Pubset angegeben wurde.
CLONE-TYPE=
Legt den Clone-Typ (und damit auch die Replikationsfunktion) fest, der verwendet wird.
CLONE-TYPE = *BY-PRESELECTION
Es wird der Clone-Typ verwendet, der in der SHC-OSD-Parameterdatei voreingestellt ist. Voreinstellung in der SHC-OSD-Parameterdatei: MIRROR.
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.
SELECT =
Festlegung, ob die beim Operanden UNIT angegebene Unit oder (beim Einsatz der remote Replikation) die Target-Unit eines Remote-Copy-Paares als Original-Unit des Clone-Paares ausgewählt wird.
SELECT = *STD
Auswahl der Unit, die mit dem Operanden UNIT festgelegt wurde.
SELECT = *TARGET-UNIT
Auswahl der Target-Unit eines Remote-Copy-Paares als Original-Unit. Beim Operanden UNIT wird die entsprechende Source-Unit angegeben. Concurrent Remote-Copy wird hier nicht unterstützt.
WAIT =
Bestimmt, ob das Kommando auf die Beendigung der Synchronisation wartet oder nicht.
WAIT = *NO
Das Kommando wartet nicht auf die Beendigung der Synchronisation.
WAIT = *UNTIL-SYNCHRONIZATION
Das Kommando wartet auf die Beendigung der Synchronisation.WAIT=*UNTIL-SYNCHRONIZATION vereinfacht die Programmierung von Testprozeduren, weil aufwändige Abfragen bezüglich des Synchronisationsfortschritts entfallen.
Kommando-Verarbeitung
Die Meldung NDE1073 wird pro Gerät nach SYSOUT ausgegeben und über Routing-Code 0 verteilt, d.h. sie wird nur in der CONSLOG-Datei protokolliert. Detaillierte Informationen zur CONSLOG-Datei (Protokolldatei) finden Sie im Handbuch „Systembetreuung“ [5].
Beispiele
/START-CLONE-SESSION UNIT=5000,CLONE-UNIT=5040,CLONE-TYPE=*MIRROR
/START-CLONE-SESSION UNIT=*BY-PUBSET(PUBSET=TFC),CLONE-UNIT=(5100,5101,5102)
(Pubset TFC besteht aus 3 Units)
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 | NDE1006 | Pubset/Volume ist allokiert | |
64 | NDE1008 | Volume kann nicht allokiert werden | |
64 | NDE1015 | Gerät in BS2000 nicht bekannt | |
64 | NDE1043 | Pubset-Typ nicht unterstützt | |
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 | NDE1108 |
| |
64 | NDE1109 |
| |
64 | NDE1140 | MN in MN-Liste mehrfach verwendet | |
64 | NDE1142 | Spiegelpaar existiert schon | |
64 | NDE1143 | Fehler bei Bearbeitung des Spiegelpaares | |
64 | NDE1171 | Target-Unit nicht eindeutig | |
64 | NDE1181 | Maximale Anzahl an dynamischen Spiegeln überschritten | |
64 | NDE1435 | Gerät ist ein Virtual Device | |
64 | NDE1511 | Clone-Paar ist bereits kaskadiert | |
64 | NDE1531 | Unterschiedliche Anzahl von Geräten für Units und Clone-Units | |
64 | NDE1534 | Clone-Unit wird bereits in anderem Paar benutzt | |
64 | NDE1535 | Gerät ist eine Clone-Unit | |
64 | NDE1537 | MNs der Unit und Clone-Unit sind identisch | |
64 | NDE1538 | Unit und Clone-Unit sind unterschiedlichen Typs oder Größe | |
64 | NDE1539 | Unit und Clone-Unit sind auf verschiedenen Storage-Systemen | |
64 | NDE1540 | Falscher Status der Unit | |
64 | NDE1541 | Falscher Status der 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 | 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 | NDE1839 | Unit und Clone-Unit sind auf verschiedenen Storage-Systemen | |
64 | NDE1852 | Maximum an lokalen Spiegeln wurde überschritten | |
64 | NDE1853 | Storage-Unit gesperrt | |
64 | NDE1880 | Copy-Lizenz nicht installiert | |
64 | NDE1881 | Copy Table Size nicht eingerichtet | |
64 | NDE1882 | Copy Table Size zu klein | |
64 | NDE1883 | Advanced copy Operationen fuer Volume 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 | NDE2009 | Kommandobearbeitung mit K2-Taste abgebrochen | |
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 |