Storage-System: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
/ACTIVATE-SNAP bietet die Umbenennung eines aktivierten Snapshot-Pubsets an. Für Symmetrix aktiviert es Snap-Paare.
Beim Operanden UNIT werden immer die Original-Units der Snap-Paare angegeben.
Bei der Auswahl der Original-Units über einen Pubset (UNIT=*BY-PUBSET) muss es zu allen Units des Pubsets Snap-Units geben. Der Snap-Pubset auf den Snap-Units kann mit dem Operanden NEW-PUBSET direkt umbenannt werden, wenn es sich um einen SF-Pubset handelt.
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 SnapOPC+ auf ETERNUS DX/AF und TimeFinder SnapVX auf VMAX3
Snap-Paare sind nach /START-SNAP-SESSION sofort aktiviert. Sie haben dann den Status COPY-ON-WRITE.
/ACTIVATE-SNAP bietet die Umbenennung eines bereits aktivierten Pubsets, bestehend aus Snap-Units (Operand *BY-PUBSET(...)). Der Status der Snap-Paare bleibt unverändert.
Für TimeFinder/Snap auf Symmetrix
/ACTIVATE-SNAP aktiviert ein oder mehrere Snap-Paar(e), die aus je einer Original-Unit und einer Snap-Unit bestehen. Nach erfolgreicher Aktivierung sind Original- und Snap-Unit getrennt. Beide sind für Anwendungen vom Host aus verfügbar. Aus Sicht der Anwendung enthält die Snap-Unit alle Daten der Original-Unit zum Zeitpunkt der Kommando-Verarbeitung.
Das Kommando wird nur ausgeführt, wenn das Snap-Paar den Status CREATED besitzt.
Mit dem Operanden SNAP-UNIT kann die zu aktivierende Snap-Unit ausgewählt werden, falls es für eine Original-Unit mehrere Paare im Status CREATED gibt. Standardmäßig wird die erste mögliche Snap-Unit aktiviert.
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 Snap-Paares sein. In diesem Fall wird beim Operanden UNIT die Source-Unit angegeben und mit dem Operanden SELECT=*TARGET-UNIT das Snap-Paar an der Target-Unit ausgewählt.
Nachdem das Snap-Paar aktiviert/getrennt ist, beginnt der Copy-On-First-Write-Prozess (siehe Kapitel „Lokale Replikation mit Snapshots (ETERNUS DX/AF, Symmetrix/VMAX3)"). Das Paar befindet sich im Status COPY-ON-WRITE oder COPIED.
ACTIVATE-SNAP | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Für ETERNUS DX/AF und VMAX3 ist nur UNIT=*BY-PUBSET sinnvoll.
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(...)
Nur für Symmetrix relevant.
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 Snap-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 Snap-Pubsets der Snap-Unit(s).
NEW-PUBSET = *SAME
Der Snap-Pubset der Snap-Unit(s) wird nicht umbenannt, d.h. es behält den gleichen Namen.
NEW-PUBSET = *SPECIAL-VSN
Alle Volumes der Snap-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 Snap-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 Snap-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 Symmetrix relevant.
Behandlung von Ein-/Ausgaben auf das Snap-Paar während der Abtrennung (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 Snap-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 Snap-Paare des importierten Pubsets im Zustand COPY-ON-WRITE 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 relevant.
Auswahl der Unit über 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 = <alphanum-name 2..2> / <x-text 4..4>
Nur für Symmetrix relevant.
Auswahl der Unit über den mnemotechnischen Gerätenamen des logischen Volumes.
SNAP-UNIT =
Auswahl der Snap-Units. Wenn es zu einer Unit mehrere Snap-Units gibt, muss eine bestimmte Snap-Unit ausgewählt werden.
SNAP-UNIT = *FIRST-POSSIBLE
Auswahl der ersten für das Kommando möglichen zugeordneten Snap-Unit.
SNAP-UNIT = *FROM-SHOW-OUTPUT(...)
Auswahl der Snap-Units über die Position in der Ausgabeliste von /SHOW-SNAP-SESSION-STATUS.
POSITION = <integer 1..127>
Angabe der Position der Snap-Unit.
POSITION = *LAST
Auswahl der letzten Snap-Unit in der Ausgabeliste.
SNAP-UNIT = *BY-SYMMETRIX(...)
Nur für Symmetrix relevant.
Auswahl der Snap-Unit über die interne Nummer des logischen Volumes im Storage-System.
SNAP-LOGICAL-VOLUME = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.
SNAP-UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Angabe des mnemotechnischen Gerätenamens der Snap-Units.
SELECT =
Für ETERNUS DX/AF und VMAX3 wird nur SELECT=*STD unterstützt.
Auswahl der Snap-Paare.
SELECT = *STD
Auswahl der Snap-Paare, die mit dem Operanden UNIT festgelegt wurden.
SELECT = *TARGET-UNIT(...)
Nur für Symmetrix relevant.
Auswahl der Snap-Paare, die der Target-Unit eines Remote-Copy-Paares zugeordnet sind. Beim Operanden UNIT wird die entsprechende Source-Unit angegeben.
RA-GROUP =
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.
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 | 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 | NDE1087 |
| |
64 | NDE1100 | Ungültiger Pubset-Status | |
64 | NDE1101 |
| |
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 | NDE1110 |
| |
64 | NDE1111 | Platte ist DRV-belegt, HOLD-IO nicht möglich | |
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 | NDE1153 | Symmetrix Device-Lock gesetzt | |
64 | NDE1154 | Platte ist Member eines Meta-Volume | |
64 | NDE1155 | RAID10-Geräte werden nicht unterstützt | |
64 | NDE1171 | RA-Gruppe nicht eindeutig | |
64 | NDE1172 | RA-Gruppe für die angegebene Unit ungültig | |
64 | NDE1430 | Keine Snap-Funktion für Gerät | |
64 | NDE1431 | Unterschiedliche Geräteanzahl bei den Angaben Unit und Snap-Unit | |
64 | NDE1435 | Gerät ist eine virtuelle Unit | |
64 | NDE1437 | MNs der Unit und Snap-Unit sind identisch | |
64 | NDE1438 | Unit und virtuelle Snap-Unit sind unterschiedlichen Typs | |
64 | NDE1440 | Falscher Status der Unit (eines Snap-Paares) | |
64 | NDE1441 | Falscher Status der Snap-Unit | |
64 | NDE1449 | Keine Snap-Unit zugeordnet für Snap-Unit Selektion | |
64 | NDE1453 | Gerät ist keine Snap-Unit | |
64 | NDE1454 | Gerät ist ungenutzte Snap-Unit | |
64 | NDE1484 | Snap-Paar bereits aktiviert | |
64 | NDE1492 | Snap-Paar bereits getrennt und Snap-Unit umbenannt | |
64 | NDE1496 | Snap-Paar(e) bereits aktiviert | |
64 | NDE1702 | Verbindung zu SYMAPI-Server abgebrochen | |
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 | 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 | 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 | NDE2018 | Fehler im SYMAPI-Server während der aktuellen Bearbeitung | |
130 | NDE1082 | Speicherengpass während der Bearbeitung des Kommandos | |
130 | NDE2005 | Kommando kann momentan nicht ausgeführt werden |