Storage-System: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
/ACTIVATE-CLONE aktiviert ein oder mehrere Clone-Paar(e), die aus je einer Original-Unit und einer Clone-Unit bestehen. Nach erfolgreicher Aktivierung sind die Original-Unit und die Clone-Unit getrennt: 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 einen Pubset (UNIT=*BY-PUBSET) muss es zu allen Units des Pubsets Clone-Units geben. Der Clone-Pubset auf den Clone-Units kann mit dem Operanden NEW-PUBSET direkt umbenannt werden, wenn es sich um einen SF-Pubset handelt.
Mit dem Operanden CLONE-UNIT kann die zu aktivierende Clone-Unit ausgewählt werden, falls es für eine Original-Unit mehrere Paare im Zustand CREATED gibt. Standardmäßig wird die erste Clone-Unit aktiviert.
Die Datenkonsistenz über mehrere Volumes ist vom Aufrufer sicherzustellen. Vor Aufruf des Kommandos sollte dazu ein Konsistenzpunkt für die Daten erstellt werden, siehe Abschnitt „Clone-Paare aktivieren".
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-Clone auf ETERNUS DX/AF
Das Kommandos wird für diese Funktion nicht benötigt und deshalb abgewiesen.
Für EC-Clone auf ETERNUS DX/AF
Das Kommando wird nur ausgeführt, wenn das Clone-Paar den Status SYNCHRONIZED besitzt.
Mit dem Operanden CLONE-UNIT kann die zu aktivierende Clone-Unit ausgewählt werden, wenn es für eine Original-Unit mehrere Paare im Zustand SYNCHRONIZED gibt.
Standardmäßig wird die erste mögliche Clone-Unit aktiviert.
Wenn die Funktion REC eingesetzt wird, kann die Original-Unit auch gleichzeitig die Source-Unit eines Remote-Copy-Paares sein. Auch die Target-Unit kann Original-Unit eines Clone-Paares sein. In diesem Fall wird beim Operanden UNIT die Source-Unit angegeben und mit dem Operanden SELECT=*TARGET-UNIT das Clone-Paar der Target-Unit ausgewählt. In einer solchen Konfiguration wird kein Concurrent Remote-Copy unterstützt.
Nachdem das Clone-Paar aktiviert wurde, gelangt es in den Zustand SPLIT.
Für TimeFinder/Clone auf Symmetrix/VMAX3
Das Kommando wird nur ausgeführt, wenn das Clone-Paar den Status CREATED, RECREATED oder PRECOPY besitzt.
Wenn die Funktion SRDF eingesetzt wird, kann die Original-Unit auch gleichzeitig die Source-Unit eines Remote-Copy-Paares sein. Auch die Target-Unit kann Original-Unit eines Clone-Paares sein. In diesem Fall wird beim Operanden UNIT die Source-Unit angegeben und mit dem Operanden SELECT=*TARGET-UNIT das Clone-Paar an der Target-Unit ausgewählt.
Nachdem das Clone-Paar aktiviert/getrennt ist, beginnt der Copy-On-Access-Prozess (siehe „Überblick“, „TimeFinder/Clone (Symmetrix/VMAX3)"). Das Paar ist im Zustand COPY-ON-ACCESS, COPY-IN-PROGRESS oder COPIED, je nachdem, mit welchen Optionen es erstellt wurde (siehe Kommando /START-CLONE-SESSION im "START-CLONE-SESSION Clone-Paar erstellen").
ACTIVATE-CLONE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. Wenn ein SF-Pubset ausgewählt wird, können die Volumes des Clone-Pubsets mit NEW-PUBSET umbenannt werden.
PUBSET = <cat-id 1..4>
Angabe der Pubset-ID oder Volume-Set-ID. Bei HOLD-IO=*UNTIL-ACTIVATED darf keine Volume-Set-ID angegeben werden.
NEW-PUBSET =
Bestimmt die Katalogkennung des Clone-Pubsets.
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 eines SF-Pubsets 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 =
Behandlung von Ein-/Ausgaben auf das Clone-Paar während der Abtrennung (siehe „Konsistente Abtrennung eines Pubsets auch im Shared-Pubset-Verbund“, „Clone-Paare aktivieren").
HOLD-IO = *NO
Die Ein-/Ausgaben auf das Clone-Paar 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 das Clone-Paar werden angehalten, bis alle Clone-Paare des importierten Pubsets im Zustand COPY-ON-ACCESS sind. Danach werden die Ein-/Ausgaben auf den 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-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 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 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 = *LAST
Auswahl der letzten Clone-Unit in der Ausgabeliste.
POSITION = <integer 1..16>
Angabe der Position der Clone-Unit.
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 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 .
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.
FORCE =
Nur für Symmetrix/VMAX3 relevant.FORCE steuert die Aktivierung eines Clone-Paares mit einer Clone-Unit, die gleichzeitig eine SRDF-Source-Unit im Remote-Copy-Status ERROR und nicht zugreifbar ist. (Die Clone-Session ist in diesem Fall in einem der Zustände PRECOPY, CREATED oder RECREATED.)
FORCE = *NO
Die Aktivierung wird abgewiesen.
FORCE = *YES
Die Aktivierung wird ausgeführt. Der Remote-Copy-Status wird ACTIVE.
WAIT =
Nur für Symmetrix/VMAX3 relevant.
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 für die Recovery-Verfahren, weil aufwändige Abfragen bezüglich des Synchronisationsfortschritts entfallen.
Der Wartevorgang kann im Dialog-Betrieb mit der K2-Taste abgebrochen werden.
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
/ACTIVATE-CLONE UNIT=*BY-PUBSET(PUBSET=OLD,NEW-PUBSET=*SAME)
/ACTIVATE-CLONE UNIT=*BY-PUBSET(PUBSET=OLD,NEW-PUBSET=NEW,
HOLD-IO=*UNTIL-ACTIVATED)
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 |
| |
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 | 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 | NDE1044 |
| |
64 | NDE1057 | Funktion nicht unterstützt | |
64 | NDE1087 |
| |
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 | NDE1104 |
| |
64 | NDE1105 | Inkonsistenter Pubset | |
64 | NDE1108 |
| |
64 | NDE1109 |
| |
64 | NDE1114 | Seriennummer nicht gefunden | |
64 | NDE1115 | Seriennummer nicht eindeutig | |
64 | NDE1116 | Logical Volume nicht gefunden | |
64 | NDE1120 | Fehler beim Wiederaufnehmen von Ein/Ausgaben auf Pubset | |
64 | NDE1143 | Fehler bei Bearbeitung des Spiegelpaares | |
64 | NDE1153 | Symmetrix Device-Lock gesetzt | |
64 | NDE1154 | Platte ist Member eines Meta-Volume | |
64 | NDE1155 | RAID10 Geräte nicht unterstützt | |
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 | NDE1584 | Clone-Paar bereits aktiviert | |
64 | NDE1592 | Clone-Paar bereits aktiviert und Clone-Unit umbenannt | |
64 | NDE1596 | Clone-Paar(e) bereits aktiviert | |
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 | keinen passenden 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 | NDE2009 | Kommandobearbeitung mit K2-Taste abgebrochen | |
64 | NDE2011 | Keine Symmetrix/VMAX3-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 |