Storage-System: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS, OPERATING, HW-MAINTENANCE, |
Berechtigungsschlüssel: | @ |
/SHOW-SNAP-SESSION-STATUS
informiert über den Status von Snap-Paaren im Storage-System.
Bei der Geräteauswahl ermittelt SHC-OSD automatisch die richtigen Volumes auf dem entsprechenden Storage-System und gibt dann die für das System relevanten Daten aus. Es können immer nur Snap-Paare eines Storage-System-Typs ausgewählt werden (d.h. ETERNUS DX/AF oder Symmetrix/VMAX3).
Das Kommando unterstützt die strukturierte Ausgabe in S-Variablen (zur Arbeitsweise siehe Handbuch „Kommandos“ [1]).
SHOW-SNAP-SESSION-STATUS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 = list-poss(24): <vsn 1..6>
Angabe der Archivnummer des Volumes.
UNIT = *BY-PUBSET(...)
Auswahl der Units über eine Pubset-ID oder Volume-Set-ID. Die Informationen werden über alle Volumes des angegebenen Pubsets ausgegeben. Es können Kennungen von SF-Pubsets, Volume-Sets oder importierten SM-Pubsets angegeben werden. Für exportierte SM-Pubsets werden keine Informationen ausgegeben.
PUBSET = list-poss(24): <cat-id 1..4>
Angabe der Pubset-ID oder Volume-Set-ID.
UNIT = *BY-SYMMETRIX(...)
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Units ü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 = *ALL
Alle logischen Volumes des Storage-Systems werden ausgewählt.
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 Units über die interne Nummer des logischen Volumes im Storage-System.
SERIAL-NUMBER = *ALL
Alle Storage-Systeme werden ausgewählt.
Es werden alle bekannten Snap-Paare ausgegeben. Zusätzlich werden die freien Snap-Units im Status UNUSED ausgegeben, sofern sie als Snap Data Volumes (SDVs) konfiguriert sind.
Die Bearbeitung des Kommandos kann bei dieser Angabe und mehreren Storage-Systemen etwas Zeit in Anspruch nehmen.
SERIAL-NUMBER = <alphanum-name 3..14>
Angabe der Seriennummer des Storage-Systems (Eindeutigkeit beachten!).
LOGICAL-VOLUME = *ALL
Alle logischen Volumes des Storage-Systems werden ausgewählt.
LOGICAL-VOLUME = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.
UNIT = list-poss(24): <alphanum-name 1..4 with-wildcards>
Auswahl der Units über den mnemotechnischen Gerätenamen des logischen Volumes.
SELECT =
Auswahl der Units über den Status der Snap-Unit, ihre Remote-Copy-Nutzung oder ihren Status aus Sicht von BS2000.
SELECT = *ALL-PRESELECTED
Die Menge der Units wird nicht weiter eingeschränkt. Es gilt die globale Einstellung für SHC-OSD (Wert von DEVICE-PRESELECTION
in der Ausgabe von /SHOW-SHC-PROCESSING
).
SELECT = *BY-ATTRIBUTES(...)
Die Menge der Units wird über Auswahlkriterien eingeschränkt.
SNAP-STATUS =
Nur für Symmetrix und ETERNUS DX/AF relevant, nicht für VMAX3.
Auswahl der Units über den Status der Snap-Unit.
SNAP-STATUS = *ANY
Die Informationen werden über alle Units ausgegeben, unabhängig vom Status der Snap-Unit.
SNAP-STATUS = *UNUSED
Die Informationen werden nur über freie Snap-Units (Virtual Devices) im Status UNUSED
ausgegeben.
Thin Devices oder Flex Volumes, die in einem Storage-System ETERNUS DX/AF als Snap-Units verwendet werden können, werden hier nicht angezeigt.
SNAP-STATUS = *IN-USE
Die Informationen werden nur über Snap-Paare ausgegeben, bei denen die Snap-Unit einen Status ungleich UNUSED
hat.
REMOTE-COPY-USE =
Auswahl der Units mit der angegebenen Remote-Copy-Nutzung.
REMOTE-COPY-USE = *STD
Die Informationen werden über alle Units ausgegeben, unabhängig von ihrer Remote-Copy-Nutzung.
REMOTE-COPY-USE = *TARGET-UNIT(...)
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 =
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>
Die Target-Units zu der angegebenen Source-RA-Gruppe werden ausgewählt.
DEVICE =
Auswahl der Units über ihren Status aus Sicht des BS2000.
DEVICE = *ALL-PRESELECTED
Auswahl aller Units entsprechend der globalen Einstellung für SHC-OSD (Wert von DEVICE-PRESELECT
in der Ausgabe von /SHOW-SHC-PROCESSING
).
DEVICE = *ALL-DEFINED
Auswahl aller in BS2000 generierten Units.
DEVICE = *DETACHED
Auswahl aller in BS2000 generierten, aber weggeschalteten Units.
DEVICE = *ATTACHED
Auswahl aller in BS2000 zugeschalteten Units.
DEVICE = *ANY
Auswahl aller Units des Storage-Systems, das beim Operanden UNIT
angegeben wurde.
INFORMATION =
Auswahl der Information über die Snap-Paare.
INFORMATION = *STD
Alle zugeordneten Snap-Units werden angezeigt.
INFORMATION = *ALL
Nur für Symmetrix relevant.
Alle zugeordneten Snap-Units werden mit dem Namen des Save Pools angezeigt.
UPDATE =
Steuert die Aktualisierung der bereitgestellten Daten.
UPDATE = *STD
Vor Ausführung des Kommandos werden die Daten in SHC-OSD aktualisiert.
UPDATE = *NO
Das Kommando wird ohne Aktualisierung der Daten in SHC-OSD ausgeführt.
Beispiele
/SHOW-SNAP-SESSION-STATUS UNIT=*BY-PUBSET(PUBSET=ABC)
/SHOW-SNAP-SESSION-STATUS UNIT=*BY-STORAGE(SERIAL-NUM=227,LOGICAL-VOLUME=100)
/SHOW-SNAP-SESSION-STATUS UNIT=*BY-SYMMETRIX(SERIAL-NUM=227, LOGICAL-VOLUME=100),REMOTE-COPY-USE=*TARGET-UNIT(RA-GROUP=*UNIQUE)
Ausgabe für Snap-Paare
Das Layout der SYSOUT-Ausgabe unterscheidet sich, da nicht alle Ausgabefelder von allen Storage-Systemen versorgt werden. SHC-OSD wählt automatisch das richtige Ausgabeformat.
Ausgaben für ETERNUS DX/AF
/SHOW-SNAP-SESSION-STATUS UNIT=2040 % ----------------------------------------------------------------------------- % UNIT VOLUME! ! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % SNAP- VOLUME!STATE !ACTIVE-FOR !SNAP-POOL-NAME ! % UNITS ! !DDD.HH:MM:SS! ! % ============================================================================= % 2040 ET88.0! ! ! 4531107005 00040 % 20D1 ET44.0!COPY-ON-WRITE!236.00:59:08! ! 001B6 % 20C9 ET88.0!COPY-ON-WRITE!236.01:30:14!SDP00 ! 001AE % 20E3 ET40.0!COPY-ON-WRITE!375.07:18:07!SDP00 ! 001C8 % -----------------------------------------------------------------------------
Ausgaben für Symmetrix
/SHOW-SNAP-SESSION-STATUS UNIT=8208,INFORMATION=*STD % ----------------------------------------------------------------------------- % UNIT VOLUME! ! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % SNAP- VOLUME!STATE !ACTIVE-FOR !INDIRECT SIZE PERCENT- MULTI % UNITS ! !DDD.HH:MM:SS!UNIT SNAP COPIED % ============================================================================= % 8208 ET0U.0! ! !000192601224 00240 % 8404 ET0U.0!COPY-ON-WRITE! 0.00:01:36!3840 MB 3840 MB 0 % 00400 Y % 8400 ET0U.0!COPY-ON-WRITE! 0.00:10:08!3840 MB 3840 MB 0 % 003FC Y % -----------------------------------------------------------------------------
/SHOW-SNAP-SESSION-STATUS UNIT=*BY-PUBSET(PUBSET=ET0U),INFORMATION=*ALL % ----------------------------------------------------------------------------- % UNIT VOLUME! ! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % SNAP- VOLUME!STATE !ACTIVE-FOR !INDIRECT SIZE PERCENT- MULTI % UNITS ! !DDD.HH:MM:SS!UNIT SNAP COPIED % ! ! !SAVE-POOL-NAME % ============================================================================= % 8208 ET0U.0! ! !000192601224 00240 % 8400 ETS1.0!COPY-ON-WRITE! 3.00:01:57!3840 MB 3840 MB 0 % 003FC Y % ! ! !DEFAULT_POOL % 8404 ETS2.0!COPY-ON-WRITE! 12.23:55:03!3840 MB 3840 MB 0 % 00400 Y % ! ! !DEFAULT_POOL % ----------------------------------------------------------------------------- % 8209 ET0U.1! ! !000192601224 00241 % 8401 ETS1.1!COPY-ON-WRITE! 3.00:01:57!3840 MB 3840 MB 0 % 003FD Y % ! ! !DEFAULT_POOL % 8405 ETS2.1!COPY-ON-WRITE! 12.23:55:03!3840 MB 3840 MB 0 % 00401 Y % ! ! !DEFAULT_POOL % -----------------------------------------------------------------------------
Ausgaben für VMAX3
/SHOW-SNAP-SESSION-STATUS UNIT=4960,INFORMATION=*STD % ----------------------------------------------------------------------------- % UNIT VOLUME! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % SNAP- VOLUME!SNAPSHOT-NAME GEN!STATUS !ACTIVE-FOR !SNAP- % UNITS ! ! !DDD.HH:MM:SS! VOLS % ============================================================================= % 4960 F-4960! !000296800294 001A0 % 4966 F-4966!SHCOSD-4960-4966 0!COPY-ON! 6.19:06:34!001A6 % 4967 F-4967!SHCOSD-4960-4967 0!COPY-ON! 6.23:11:52!001A7 % -----------------------------------------------------------------------------
/SHOW-SNAP-SESSION-STATUS UNIT=*BY-PUBSET(PUBSET=SNVX) % ----------------------------------------------------------------------------- % UNIT VOLUME! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % SNAP- VOLUME!SNAPSHOT-NAME GEN!STATUS !ACTIVE-FOR !SNAP- % UNITS ! ! !DDD.HH:MM:SS! VOLS % ============================================================================= % 4750 SNVX.0! !000296800293 00190 % 475C SNXX.0!SHCOSD-4750-475C 0!COPY-ON! 35.20:55:14!0019C % 4759 SNYY.0!SHCOSD-4750-4759 0!COPY-ON! 35.21:49:01!00199 % 4756 SNVZ.0!SHCOSD-4750-4756 0!COPY-ON! 35.22:02:11!00196 % 4753 SNVY.0!SHCOSD-4750-4753 0!COPY-ON! 35.22:03:24!00193 % ----------------------------------------------------------------------------- % 4751 SNVX.1! !000296800293 00191 % 475D SNXX.1!SHCOSD-4750-475C 0!COPY-ON! 35.20:55:15!0019D % 475A SNYY.1!SHCOSD-4750-4759 0!COPY-ON! 35.21:49:01!0019A % 4757 SNVZ.1!SHCOSD-4750-4756 0!COPY-ON! 35.22:02:12!00197 % 4754 SNVY.1!SHCOSD-4750-4753 0!COPY-ON! 35.22:03:25!00194 % ----------------------------------------------------------------------------- % 4752 SNVX.2! !000296800293 00192 % 475E SNXX.2!SHCOSD-4750-475C 0!COPY-ON! 35.20:55:15!0019E % 475B SNYY.2!SHCOSD-4750-4759 0!COPY-ON! 35.21:49:01!0019B % 4758 SNVZ.2!SHCOSD-4750-4756 0!COPY-ON! 35.22:02:12!00198 % 4755 SNVY.2!SHCOSD-4750-4753 0!COPY-ON! 35.22:03:25!00195 % -----------------------------------------------------------------------------
Bedeutung der Ausgabespalten (alphabetisch)
Schlüsselwort | Bedeutung | bei INF= | ||||||||||||||||||||||
| Zeitraum seit der Aktivierung |
| ||||||||||||||||||||||
| Snapshot-Generation (nur für VMAX3). | |||||||||||||||||||||||
| noch unverändert auf der jeweiligen Unit / für den jeweiligen Status (in MByte oder GByte, nur für Symmetrix) |
| ||||||||||||||||||||||
| noch unverändert auf der Unit | |||||||||||||||||||||||
| noch unverändert auf der Snap-Unit (zeigt auf Original) | |||||||||||||||||||||||
| Interne Nummer des logischen Volumes im Storage-System (Original- und SNAP-Unit) |
| ||||||||||||||||||||||
| Multi-Snap Unterstützung (bis 127 Snap-Units zu einem Original, nur für Symmetrix)
|
| ||||||||||||||||||||||
| Auf die Snap-Unit kopierte Daten in Prozent (nur für Symmetrix) |
| ||||||||||||||||||||||
| Save Pool des Snap-Paars (nur für Symmetrix) |
| ||||||||||||||||||||||
| Seriennummer des Storage-Systems |
| ||||||||||||||||||||||
| Snap Pool-Name des Snap-Paars (ETERNUS DX/AF). |
| ||||||||||||||||||||||
| MN einer Snap-Unit oder interne Nummer des logischen Volumes im Storage-System (mit Präfix #). |
| ||||||||||||||||||||||
| Interne Nummer des logischen Volumes im Storage-System (Snap-Unit, nur für VMAX3). |
| ||||||||||||||||||||||
| Name des Snapshots (nur für VMAX3) |
| ||||||||||||||||||||||
|
|
| ||||||||||||||||||||||
| MN einer Unit oder interne Nummer des logischen Volumes im Storage-System (mit Präfix #) |
| ||||||||||||||||||||||
| VSN einer Unit |
|
S-Variablen
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
Anzahl der zugeordneten Snap-Units | var(*LIST).NUM-OF-SNAP-UNITS | I | <integer 0..65535> | *STD |
Seriennummer des Storage-Systems | var(*LIST).SERIAL-NO | S | '' | *STD |
Anzahl der Snapshot-Generationen (VMAX3) | var(*LIST).SNAP-UNIT(*LIST).GENERATIONS | I | <integer 0..255> | *STD |
Snapshot-Name (VMAX3) | var(*LIST).SNAP-UNIT(*LIST).SNAPSHOT-NAME | S | '' | *STD |
Zeitraum seit dem Aktivieren einer Snap-Unit im Format | var(*LIST).SNAP-UNIT(*LIST).ACTIVE-FOR | S | '' | *STD |
Interne Nummer des logischen Volumes | var(*LIST).SNAP-UNIT(*LIST).LOGIC-VOL | S | '' | *STD |
Multi-Snap Unterstützung (Y=YES, N=NO) (Symmetrix) | var(*LIST).SNAP-UNIT(*LIST).MULTI-SNAP | S | Y | *STD |
Auf die Snap-Unit kopierte Menge von Daten (Symmetrix) | var(*LIST).SNAP-UNIT(*LIST).PERCENT-COPIED | I | <integer 0..100> | *STD |
Save-/Snap Pool-Name zu einem Snap-Paar (ETERNUS DX/AF und Symmetrix) | var(*LIST).SNAP-UNIT(*LIST).SAVE-POOL-NAME | S | '' | *STD |
unveränderte Daten auf der Snap-Unit während des Zustands *COPY-ON-WRITE (in MByte) (Symmetrix) | var(*LIST).SNAP-UNIT(*LIST).SNAP-INDIRECT-SIZE | I | <integer 0..268435456> | *STD |
Geräte-Status einer Snap-Unit | var(*LIST).SNAP-UNIT(*LIST).STA | S | *UNUSED | *STD |
MN einer Snap-Unit | var(*LIST).SNAP-UNIT(*LIST).UNIT | S | '' | *STD |
unveränderte Daten auf der Unit (in MByte) (Symmetrix) | var(*LIST).SNAP-UNIT(*LIST).UNIT-PROTECTED-SIZE | I | <integer 0..268435456> | *STD |
VSN einer Snap-Unit | var(*LIST).SNAP-UNIT(*LIST).VOL | S | '' | *STD |
MN einer Unit | var(*LIST).UNIT | S | '' | *STD |
Interne Nummer des logischen Volumes | var(*LIST).UNIT-LOGIC-VOL | S | <c-string 1..5> | *STD |
VSN einer Unit | var(*LIST).UNIT-VOL | S | '' | *STD |
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
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 | NDE1002 | Steuerung nicht gefunden | |
64 | NDE1003 | Datenträger nicht online oder nicht eindeutig | |
64 | NDE1004 | Pubset nicht gefunden oder falscher Pubset-Typ | |
64 | NDE1010 | Enginuity-Stand wird nicht unterstützt (zu niedrig) | |
64 | NDE1043 | Pubset-Typ nicht unterstützt | |
64 | NDE1100 | Ungültiger Pubset-Status | |
64 | NDE1114 | Seriennummer nicht gefunden | |
64 | NDE1115 | Seriennummer nicht eindeutig | |
64 | NDE1116 | Logical Volume im Storage-System nicht gefunden | |
64 | NDE1119 | Keine Target-Unit gefunden | |
64 | NDE1125 | Initialisierung der Storage-System Informationen läuft | |
64 | NDE1126 | Gerät unbekannt oder Storage-System nicht unterstützt | |
64 | NDE1127 | Gerät eines Storage-Systems ist nicht durch SHC-OSD zugreifbar | |
64 | NDE1128 | mindestens eine Unit aus System, das nicht Symmetrix/VMAX3 ist | |
64 | NDE1150 | Kein Gatekeeper-Gerät gefunden | |
64 | NDE1702 | Verbindung zu SYMAPI-Server abgebrochen | |
64 | NDE1800 | Gerät nicht gefunden oder nicht in Storage-System | |
64 | NDE1810 | Betriebssystem-Version des Storage-Systems nicht unterstützt | |
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 | NDE2000 | Teilweise erfolgreiche Ausführung | |
64 | NDE2001 | Kommando nicht ausgeführt | |
64 | NDE2006 | Keine Ausgabe-Information vorhanden | |
64 | NDE2011 | Keine Symmetrix-Lizenz eingetragen | |
64 | NDE2020 | Keine Lizenz für lokale Replikation (ETERNUS DX/AF) | |
130 | NDE1082 | Speicherengpass während der Bearbeitung des Kommandos |