Storage-System: | ETERNUS DX/AF |
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 „Konsistenzpunkt für Replikationen".
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
Das Kommandos wird für diese Funktion nicht benötigt und deshalb abgewiesen.
Für EC-Clone
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.
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-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-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 = 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 = *LAST
Auswahl der letzten Clone-Unit in der Ausgabeliste.
POSITION = <integer 1..16>
Angabe der Position der Clone-Unit.
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 .
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.
Die Auswahl kann nur erfolgen wenn die Target-Unit eindeutig ist. Concurrent Remote-Copy wird hier nicht unterstützt.
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 | 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 | NDE1120 | Fehler beim Wiederaufnehmen von Ein/Ausgaben auf Pubset | |
64 | NDE1143 | Fehler bei Bearbeitung des Spiegelpaares | |
64 | NDE1171 | Target-Unit nicht eindeutig | |
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 | 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 | 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 |