Storage-System: | ETERNUS DX/AF |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
/RESTORE-FROM-CLONE rekonstruiert die Original-Unit eines Clone-Paares von der Clone-Unit.
Bei der Ausführung des Kommandos werden die Daten von der Clone-Unit zur Original-Unit kopiert. Auf beide darf kein anderer Zugriff stattfinden. Nach Starten des Kopierprozess ist wieder Zugriff auf die Original-Unit möglich.
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.
Für die Rekonstruktion können die Clone-Units explizit (z.B. über die Katalogkennung eines umbenannten Pubsets) oder implizit nach ihrer Position in einer SYSOUT-Ausgabe (Operand *FROM-SHOW-OUTPUT(...)) ausgewählt werden.
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
Nach Abschluss der Rekonstruktion sind die Clone-Paare weiterhin im Status SPLIT.
Bei einem Restore für ein Pubset muss das Original-Pubset exportiert sein. Die Datenkonsistenz über mehrere Volumes ist vom Aufrufer sicherzustellen.
Wenn die Funktion REC eingesetzt wird, dann 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. An der Target-Unit ist aber keine Rekonstruktion auf die Original-Unit möglich.
Für EC-Clone
Die Rekonstruktion erfolgt in SHC-OSD in mehreren Schritten, die im Kommando zusammengefasst sind.
Nach Abschluss der Rekonstruktion sind die Clone-Paare weiterhin im Status SPLIT.
Wenn die Funktion REC eingesetzt wird, dann 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. An der Target-Unit ist aber keine Rekonstruktion auf die Original-Unit möglich.
RESTORE-FROM-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. Der entsprechende Clone-Pubset wird automatisch gefunden.
PUBSET = <cat-id 1..4>
Angabe der Pubset-ID oder Volume-Set-ID.
ACHTUNG!
Bei der Rekonstruktion eines Pubsets von den Clone-Units mit UNIT=*BY-PUBSET(...) darf der Pubset zwischenzeitlich nicht rekonfiguriert und insbesondere nicht verkleinert worden sein. Die ausgewählten Clone-Units müssen ein konsistentes Pubset enthalten.
RENAME-PUBSET =
Angabe der Pubset-ID oder Volume-Set-ID des rekonstruierten Pubsets.
RENAME-PUBSET = *NO
Es erfolgt keine Umbenennung des rekonstruierten Pubsets. Die Pubset-ID des Clone-Pubsets wird implizit übernommen.
RENAME-PUBSET = *SAME
Der rekonstruierte Pubset wird auf die Pubset-ID oder Volume-Set-ID des Original-Pubsets umbenannt.
RENAME-PUBSET = <cat-id 1..4>
Der rekonstruierte Pubset wird auf die angegebene Pubset-ID oder Volume-Set-ID umbenannt.
HOLD-IO =
Nur für QuickOPC relevant.
Behandlung von Ein-/Ausgaben auf das Clone-Paar während des Starts der Rekonstruktion (siehe „Konsistente Abtrennung eines Pubsets auch im Shared-Pubset-Verbund" (Konsistenzpunkt für Replikationen)).
HOLD-IO = *NO
Die Ein-/Ausgaben auf die Clone-Units werden unverändert ausgeführt. Dies kann auf den Original-Units zu Dateninkonsistenz führen für Anwendungen, die vor der Rekonstruktion nicht angehalten werden.
HOLD-IO = *UNTIL-RESTORED
Die Ein-/Ausgaben auf die Clone-Units werden angehalten, bis alle Clone-Paare des importierten Clone-Pubsets im Zustand REST-IN-PROG sind. Danach werden die Ein-/Ausgaben auf die Clone-Units wieder aufgenommen. Wenn beim Anhalten oder Wiederaufnehmen der Ein-/Ausgaben ein Fehler auftritt, wird das Kommando mit der Meldung NDE1120 abgebrochen, auch eine optionale Umbenennung des Original-Pubsets erfolgt in diesem Fehlerfall nicht mehr, das bereits rekonstruierte Original-Pubset behält die implizit übernommene Pubset-ID des Clone-Pubsets. 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 Units ü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 = *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.
CLONE-TYPE=
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.
WAIT =
Bestimmt, ob das Kommando auf die Beendigung der Wiederherstellung wartet oder nicht.
WAIT = *STD
Bei Replikation kann mit EC nur WAIT=*UNTIL-RESTORED verwendet werden.
WAIT = *NO
Das Kommando wartet nicht auf die Beendigung der Wiederherstellung.
WAIT = *UNTIL-RESTORED
Das Kommando wartet auf die Beendigung der Wiederherstellung. WAIT=*UNTIL-RESTORED vereinfacht die Programmierung von Testprozeduren für Recovery-Verfahren, weil aufwändige Abfragen bezüglich des Fortschritts der Wiederherstellung für die Clone-Paare entfallen.
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.
Kommando-Verarbeitung
Folgende Meldungen werden pro Director 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:
NDE1073Für nicht-erfolgreiche Bearbeitung:
NDE2007
Beispiele
/RESTORE-FROM-CLONE UNIT=*BY-PUBSET(PUBSET=TFC),CLONE-UNIT=*FIRST-POSSIBLE
/RESTORE-FROM-CLONE UNIT=*BY-VOLUME(VOLUME=TFC.00)
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 | NDE1015 | Gerät in BS2000 nicht bekannt | |
64 | NDE1043 | Pubset-Typ nicht unterstützt | |
| 64 | NDE1057 | Funktion nicht unterstützt | |
| 64 | NDE1087 | HOLD-IO=*UNTIL-RESTORED nur für importierte Pubsets möglich | |
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 |
| |
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 | NDE1531 | Unterschiedliche Anzahl von Geräten für Units 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 | NDE1800 | Gerät nicht gefunden oder nicht im 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 | NDE1822 | Rekonstruktionsschritt | |
64 | NDE1823 | Rekonstruktionsschritt | |
64 | NDE1824 | Rekonstruktionsschritt | |
64 | NDE1833 | kein passender StorMan-Server gefunden | |
64 | NDE1853 | Storage-Unit gesperrt | |
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 |