SHOW-VOLUME-GROUP Namen aller vorhandenen Datenträgergruppen anzeigen

Mit dieser Anweisung können die Namen aller vorhandenen Volume-Gruppen angezeigt werden.

Eine Volume-Gruppe besteht aus logisch verwandten Bändern, die vom MAREN-Benutzer zu einer Volume-Gruppe kombiniert werden. Die Volume-Gruppe ist ein zusätzliches Katalogeintragsfeld im Volume-Katalog und keine separate Verwaltungseinheit. Verwandte Bänder können zu einer Volume-Gruppe kombiniert werden. Alle Dateien, die sich auf dem Band befinden, gehören zur selben Volume-Gruppe. Wenn eine Volume-Gruppe für eine Datei auf einem Band definiert ist, aktualisiert MAREN automatisch alle dateispezifischen Katalogeinträge dieses Bandes. Einer Volume-Gruppe können nur reservierte Bänder zugeordnet werden. Wenn das Band freigegeben wird, wird die Zuordnung zur Volume-Gruppe von MAREN wieder aufgelöst.

Format

SHOW-VOLUME-GROUP                                                                                                         Kurzname: SHVG

,GROUP = *ALL
,OUTPUT = *SYSOUT  / *NONE
,STRUCTURE-OUTPUT = *NONE / <composed-name 1..255> (...)
	<composed-name 1..255> (...)
		|	WRITE-MODE = *REPLACE / *EXTEND

Operanden

GROUP = *ALL
Wählt die Namen aller vorhandenen Volume-Gruppen aus.

OUTPUT =
Bestimmt das Ausgabemedium. Voreingestellt ist die Ausgabe nach SYSOUT.

OUTPUT = *SYSOUT
Die Ausgabe erfolgt nach SYSOUT.

OUTPUT = *NONE
Es erfolgt keine Ausgabe. Diese Angabe ist nur sinnvoll bei strukturierter Ausgabe in eine S-Variable (siehe Operand STRUCTURE-OUTPUT).

STRUCTURE-OUTPUT =
Steuert die strukturierte Ausgabe in S-Variablen.

STRUCTURE-OUTPUT = *NONE
Es erfolgt keine strukturierte Ausgabe.

STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Name der S-Variable, die für die strukturierte Ausgabe verwendet werden soll.

WRITE-MODE =
Bestimmt, ob die Ausgabe den aktuellen Inhalt der S-Variablen ersetzen oder ergänzen soll.

WRITE-MODE = *REPLACE
Der aktuelle Inhalt der S-Variable wird durch die neue Ausgabe ersetzt.

WRITE-MODE = *EXTEND
Die neue Ausgabe erweitert den aktuellen Inhalt der S-Variable.

Beispiele

Beispiel 1: Namen aller vorhandenen Volume-Gruppen anzeigen

//show-volume-group group=*ALL

---------------------------------------------------------------------

VOLUME-GROUP NAME:


---------------------------------------------------------------------

vol-group1
vol-group2
vol-group3
vol-group4      

---------------------------------------------------------------------

% MARM309  4 VOLUME-GRUPPEN GEFUNDEN

% MARM170 ANWEISUNG '//SHOW-VOLUME-GROUP' AUSGEFUEHRT

Ausgabe in S-Variablen

Die Anweisung unterstützt die strukturierte Ausgabe in S-Variablen (gesteuert durch den Operanden STRUCTURE-OUTPUT). Nähere Informationen zu S-Variablen finden Sie im Handbuch „Kommandos“ [3].

Ausgabe-Information	Name of the S variable	T	Contents
Zugriffszähler (8-stellig) Er wird bei jedem Zugriff auf das Band hochgezählt.	var(*LIST).ACCESS-COUNT	S	<integer 0..99999999>
Erstellungsdatum	var(*LIST).CRE-DATE	S	yyyy-mm-dd
Erstellungs-Jobname Bei HSMS Request-Name	var(*LIST).CRE-JOB-NAME	S	’’ <name 1..8>
Erstellungsuhrzeit	var(*LIST).CRE-TIME	S	hh:mm:ss
Gerätetyp	var(*LIST).DEV-TYPE	S	<structured-name 1..8>
Name eines Directory (mit Katalog- und Benutzerkennung), in dem das Band enthalten ist.	var(*LIST).DIR-NAME	S	<filename 1..54 >
Anzeige, ob das Band das mitgesicherte Directory enthält	var(*LIST).DIR-ON-VOL	S	*NO *YES
Zustand (exportiert oder nicht)	var(*LIST).EXPORTED	S	*NO *YES
Erste Archivnummer des MF/MV-Sets	var(*LIST).FIRST-VOL	S	<vsn>
Dateiname einer Banddatei Ohne Katalog- und Benutzerkennung. Sofern die Datei nicht in einem Directory enthalten ist	var(*LIST).F-NAME	S	<filename 1..41>
Freigabedatum des Bandes Gibt an, wann die Reservierung des Bandes für eine Benutzerkennung beendet werden kann.	var(*LIST).FREE-DATE	S	yyyy-mm-dd
Freigabe-Lagerort An diesen Lagerort wird ein Band beim so genannten Aufräumlauf verlagert.	var(*LIST).FREE-LOCATION	S	<alphanum-name 1..8>
Name des Freibandpools, in dem sich dieses Band befindet, bzw. bei seiner Freigabe befinden soll	var(*LIST).FREE-POOL	S	<filename 1..54> *NO *GLOBAL *TSOS
Dateifolgenummer (4-stellig)	var(*LIST).F-SEQ	S	<integer 1..9999>
Standard-Lagerort	var(*LIST).HOME-LOCATION	S	<alphanum-name 1..8>
Name des Systems mit dem letzten Zugriff	var(*LIST).LAST-ACCESS- HOSTNAM	S	<alphanum-name 1..8>
Datum des letzten Zugriffs	var(*LIST).LAST-ACCESS-DATE	S	yyyy-mm-dd
Benutzerkennung des letzten Zugriffs	var(*LIST).LAST-ACCESS-USER-ID	S	<name 1..8>
Kennwort für den Zugriff	var(*LIST).PASS	S	*NONE *YES
Bemerkungsfeld	var(*LIST).REMARK	S	<c-string 1..24>
Reservierungs-Zähler (4-stellig) Dieser Zähler wird bei jeder Neureservierung des Bandes hochgezählt.	var(*LIST).RESERV-COUNT	S	<integer 0..9999>
Archivierungsdatum Datum der Reservierung eines Bandes	var(*LIST).RESERV-DATE	S	yyyy-mm-dd
SAVE-FILE-ID (HSMS) oder SAVE-VERSION-ID (ARCHIVE)	var(*LIST).SFID	S	<c-string 1..15>
Nummer der Subtask für den parallelen Sicherungslauf in HSMS	var(*LIST).SUBSAVE	S	<integer 0..15>
Nummer des Folgebands innerhalb eines parallelen Sicherungslaufs in HSMS	var(*LIST).SUBSEQ	S	<integer 0..999>
Mehrbenutzbarkeit des Bandes	var(*LIST).USER-ACCESS	S	OWNER-ONLY FOREIGN-READ ALL-USERS
Abrechnungsnummer des Bandeigentümers	var(*LIST).USER-ACCOUNT	S	<alphanum-name 1..8>
Benutzerfeld. Hier können beliebige Daten eingetragen werden, z.B. Name, Abteilung, oder relevante Daten für die Arbeitsvorbereitung	var(*LIST).USER-FIELD	S	<c-string 1..54>
Benutzerkennung des Bandeigentümers	var(*LIST).USER-ID	S	<name 1..8>
Archivnummer des Bandes	var(*LIST).VOL	S	<vsn>
Volume-Gruppe hat nur bei reservierten Bändern einen gültigen Wert, sonst ist sie undefiniert.	var(*LIST).VOL-GROUP	S	<text 1..32>
Bandabschnittsnummer (4-stellig)	var(*LIST).VOL-SEQ	S	<integer 1..255>
Bandstatus F = FREE P = PRIVATE R = RESERVED D = DEFECT	var(*LIST).VOL-STA-1	S	F/P/R/D