Storage-System: | ETERNUS DX/AF |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
/START-SNAP-SESSION erstellt ein oder mehrere Snap-Paar(e), indem einer Original-Unit ein virtuelles Gerät als Snap-Unit zugeordnet wird.
Beim Operanden UNIT werden immer die Original-Units der Snap-Paare angegeben.
Alternativ können die Original-Units indirekt ausgewählt werden, indem bei UNIT ein SF-Pubset oder ein Volume-Set eines SM-Pubsets angegeben wird.
In diesem Fall wird bei UNIT der Pubset ausgewählt. Bei SNAP-UNIT wird eine Liste von Volumes angegeben, die alle noch nicht als Snap-Units genutzt werden und deren Anzahl mit der Anzahl der Units des Pubsets oder des Volume-Sets ü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 SnapOPC+ auf ETERNUS DX/AF
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".
Der Server selbst kann auf die Snap-Unit sofort zugreifen.
Die Snap-Paare werden sofort aktiviert. Aus Sicht der Anwendung enthält die Snap-Unit alle Daten der Original-Unit zum Zeitpunkt der Kommando-Verarbeitung. Durch die Ausführung des Kommandos bekommt die Snap-Session den Status COPY-ON-WRITE.
Die Geräte für Original-Unit und Snap-Unit müssen in demselben Storage-System liegen und den gleichen Typ haben. Die konfigurierte Größe der Snap-Unit muss größer oder gleich der Größe der Original-Unit sein.
Es können beliebige Thin Devices oder Flex Volumes als Snap-Units verwendet werden.
Alternativ können auch noch vorkonfigurierte Snap Data Volumes (SDV) als Snap-Units verwendet werden.
Zu einer Original-Unit können maximal 256 Snap-Units eingerichtet werden.
Der Snap-Pubset auf den Snap-Units kann mit dem Operanden NEW-PUBSET direkt umbenannt werden, wenn es sich um einen SF-Pubset handelt.
Wenn für Pubsets die Datensicherung mit Snapsets genutzt wird (siehe Handbuch „Systembetreuung“ [5]), dann darf SnapOPC+ für diesen Pubset nicht genutzt werden.
START-SNAP-SESSION | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Auswahl der Original-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.
Wenn ein SF-Pubset ausgewählt wird, können die Volumes des erzeugten Snap-Pubsets direkt 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-Units.
NEW-PUBSET = *SAME
Der Snap-Pubset wird nicht umbenannt, d.h. es behält den gleichen Namen.
NEW-PUBSET = *SPECIAL-VSN
Alle Volumes der Snap-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 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 =
Behandlung von Ein-/Ausgaben auf das Snap-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 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 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 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.
SNAP-UNIT =
Auswahl der Snap-Units.
SNAP-UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Angabe des mnemotechnischen Gerätenamens des Virtual Devices. Eine Liste wird nur akzeptiert, wenn beim Operanden UNIT ein Pubset angegeben wurde.
SNAP-UNIT = *BY-STORAGE(...)
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 = *AUTO-SELECT
Automatische Auswahl passender Snap-Units durch SHC-OSD. Es werden nur Snap-Units mit exakt der gleichen konfigurierten Größe wie die Original-Unit ausgewählt.
Die Snap-Units werden abhängig vom Storage-System ausgewählt:
Zuerst aus der Menge der vorhandenen freien und zugeschalteten BS2000-Volumes in Sondernotation, siehe Abschnitt „Automatische Auswahl von Snap-Units" (Frei wählbare Snap-Units).
Falls keine passenden BS2000-Volumes in Sondernotation gefunden wurden, aus der Menge der vorhandenen freien und zugeschalteten Snap Data Volumes (SDV)
SNAP-UNIT=*AUTO-SELECT ist nur möglich für zugeschaltete Units.
SELECT =
Festlegung, ob die beim Operanden UNIT angegebene Unit oder (beim Einsatz von remote Replikation) die Target-Unit eines Remote-Copy-Paares als Original-Unit des Snap-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.
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-SNAP-SESSION UNIT=5000,SNAP-UNIT=5040
/START-SNAP-SESSION UNIT=5001,SNAP-UNIT=*AUTO-SELECT
/START-SNAP-SESSION UNIT=*BY-PUBSET(PUBSET=TFS),SNAP-UNIT=(5100,5101,5102)
(Pubset TFS besteht aus 3 Units)
/START-SNAP-SESSION UNIT=*BY-PUBSET(PUBSET=A,NEW-PUBSET=C),SELECT=*TARGET-UNIT
(siehe "SnapOPC+ und REC")
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 | NDE1008 | Volume kann nicht allokiert werden | |
64 | NDE1015 | Gerät in BS2000 nicht bekannt | |
64 | NDE1043 | Pubset-Typ nicht unterstützt | |
64 | NDE1044 |
| |
64 | NDE1058 | Alle freien Snap-Units für Snapset reserviert | |
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 | NDE1110 |
| |
64 | NDE1140 | MN in MN-Liste mehrfach verwendet | |
64 | NDE1142 | Spiegelpaar existiert schon | |
64 | NDE1171 | Target-Unit nicht eindeutig | |
64 | NDE1410 | Keine oder zu wenig freie Snap-Units | |
64 | NDE1430 | Keine Snap-Funktion für Gerät | |
64 | NDE1431 | Unterschiedliche Anzahl von Geräten für Units und Snap-Units | |
64 | NDE1434 | Virtuelle Snap-Unit wird bereits in anderem Paar benutzt | |
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 | NDE1439 | Unit und virtuelle Snap-Unit sind auf verschiedenen Storage-Systemen | |
64 | NDE1440 | Falscher Status der Unit (eines Snap-Paares) | |
64 | NDE1441 | Falscher Status der Snap-Unit | |
64 | NDE1470 | Typ der SNAP-UNIT darf nicht gemischt werden (SDV und Thin) | |
64 | NDE1535 | Gerät ist eine 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 | NDE1820 | Rekonstruktion im Storage-System noch nicht beendet | |
64 | NDE1833 | kein passender StorMan-Server gefunden | |
64 | NDE1840 | Unit und Snap-Unit sind auf verschiedenen Storage-Systemen | |
64 | NDE1850 | Alle Spiegelplatten der Unit für Snapset-Nutzung reserviert | |
64 | NDE1852 | Maximum an lokalen Spiegeln wurde überschritten | |
64 | NDE1853 | Storage-Unit gesperrt | |
64 | NDE1870 | Snap Paar erzeugt | |
64 | NDE1872 | Automatisches Zuschalten (Attach) von Snap-Unit(s) fehlgeschlagen | |
64 | NDE1880 | Copy-Lizenz nicht installiert (ETERNUS DX/AF) | |
64 | NDE1881 | Copy Table Size nicht eingerichtet (ETERNUS DX/AF) | |
64 | NDE1882 | Copy Table Size zu klein (ETERNUS DX/AF) | |
64 | NDE1883 | Advanced Copy Operationen für Geräte gesperrt (ETERNUS DX/AF) | |
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 | |
130 | NDE1082 | Speicherengpass während der Bearbeitung des Kommandos | |
130 | NDE2005 | Kommando kann momentan nicht ausgeführt werden |