SHC-OSD V15.0 (de)

&pagelevel(3)&pagelevel

Storage-System:	ETERNUS DX/AF
Anwendungsbereich:	DEVICE
Privilegierung:	TSOS, OPERATING, HW-MAINTENANCE, SW-MONITOR-ADMINISTRATION, HSMS-ADMINISTRATION
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.

Das Kommando unterstützt die strukturierte Ausgabe in S-Variablen (zur Arbeitsweise siehe Handbuch „Kommandos“ [1]).

SHOW-SNAP-SESSION-STATUS

UNIT = BY-VOLUME(...) / BY-PUBSET(...) / *BY-STORAGE(...) /
			list-poss(24): <alphanum-name 1..4 with-wildcards>
	*BY-VOLUME(...)
		\|	VOLUME = list-poss(24): <vsn 1..6>
	*BY-PUBSET(...)
		\|	PUBSET = list-poss(24): <cat-id 1..4>
	*BY-STORAGE(...)
		\|	SERIAL-NUMBER = *ALL / <alphanum-name 3..14>
		\|	,LOGICAL-VOLUME = *ALL / <x-text 1..4>
,SELECT = ALL-PRESELECTED / BY-ATTRIBUTES(...)
	*BY-ATTRIBUTES(...)
		\|	SNAP-STATUS = ANY / UNUSED / *IN-USE
		\|	,REMOTE-COPY-USE = STD / TARGET-UNIT
		\|	,DEVICE = ALL-PRESELECTED / ALL-DEFINED / ATTACHED / DETACHED / *ANY
,UPDATE = STD / NO

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 = 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-STORAGE(...)
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 =
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.

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.

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-STORAGE(SERIAL-NUM=9003,
      LOGICAL-VOLUME=100),REMOTE-COPY-USE=*TARGET-UNIT

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
 %  -----------------------------------------------------------------------------

Bedeutung der Ausgabespalten (alphabetisch)

Schlüsselwort

Bedeutung

bei INF=

ACTIVE-FOR

Zeitraum seit der Aktivierung
(/START-SNAP-SESSION), Format: DDD.HH:MM:SS

*STD

LOG-VOL

Interne Nummer des logischen Volumes im Storage-System (Original- und SNAP-Unit)

*STD

SERIAL-NO

Seriennummer des Storage-Systems

*STD

SNAP-POOL-NAME

Snap Pool-Name des Snap-Paars.
Erscheint erst nach der Zuweisung von SDPEs zum SDV, d.h. nachdem die Kapazität des SDV erschöpft ist und Bereiche im Snap Pool genutzt werden.

*STD

SNAP-UNITS

MN einer Snap-Unit oder interne Nummer des logischen Volumes im Storage-System (mit Präfix #).

*STD

STATE

Geräte-Status
`COPY-ON-WRITE`	Snap-Session ist aktiviert, die Snap-Unit ist `READY`, getrennte Verarbeitung
`REST-IN-PROG`	Unit wird von der Snap-Unit rekonstruiert, Daten werden von der Snap-Unit auf die Unit kopiert
`TERM-IN-PROG`	Das Snap-Paar wird gerade aufgelöst
`UNUSED`	Die Snap-Unit ist mit keiner Original-Unit verbunden
`FAILED`	Fehlerzustand

*STD

UNIT

MN einer Unit oder interne Nummer des logischen Volumes im Storage-System (mit Präfix #)

*STD

VOLUME

VSN einer Unit

*STD

S-Variablen

Ausgabe-Information	Name der S-Variablen	T	Inhalt	Bedingung INF =
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	'' <c-string 3..14>	*STD
Zeitraum seit dem Aktivieren einer Snap-Unit im Format `DDDD.HH:MM:SS` ohne führende Nullen	var(LIST).SNAP-UNIT(LIST).ACTIVE-FOR	S	'' <c-string 13..13>	*STD
Interne Nummer des logischen Volumes	var(LIST).SNAP-UNIT(LIST).LOGIC-VOL	S	'' <c-string 1..5>	*STD
Save-/Snap Pool-Name zu einem Snap-Paar	var(LIST).SNAP-UNIT(LIST).SAVE-POOL-NAME	S	'' <c-string 1..32>	*STD
Geräte-Status einer Snap-Unit UNUSED: Virtuelle Snap-Unit ist mit keiner Unit verbunden COPY-ON-WRITE: Snap-Paar ist aktiviert, getrennte Verarbeitung RESTORE-IN-PROGRESS: Kopieren von der Snap-Unit zur Unit (nach /RESTORE-FROM-SNAP) TERM-IN-PROGRESS: Snap-Paar wird gerade aufgelöst *FAILED: Fehlerzustand	var(LIST).SNAP-UNIT(LIST).STA	S	UNUSED COPY-ON-WRITE RESTORE-IN-PROGRESS TERM-IN-PROGRESS *FAILED	*STD
MN einer Snap-Unit	var(LIST).SNAP-UNIT(LIST).UNIT	S	'' <mnemo-name>	*STD
VSN einer Snap-Unit	var(LIST).SNAP-UNIT(LIST).VOL	S	'' <vsn>	*STD
MN einer Unit	var(*LIST).UNIT	S	'' <mnemo-name>	*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	'' <vsn>	*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	NDE1043	Pubset-Typ nicht unterstützt
	64	NDE1100	Ungültiger Pubset-Status
	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	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
	130	NDE1082	Speicherengpass während der Bearbeitung des Kommandos

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-SNAP-SESSION-STATUS Status von Snap-Paaren anzeigen

Beispiele

Ausgabe für Snap-Paare

Ausgaben für ETERNUS DX/AF

Bedeutung der Ausgabespalten (alphabetisch)

S-Variablen

Kommando-Returncode