SHOW-VSNS Archivnummern von Bändern ausgeben

Berechtigung          ADA, DA, Administrator ohne Domänen

Diese Anweisung gibt Informationen über die Archivnummern von reservierten oder freien Bändern. Die Information über reservierte Bänder kann nach Benutzerkennungen, Volume-Gruppen oder Directories ausgewählt werden. Die Information über freie Bänder kann für einen bestimmten Gerätetyp und ihre Zuordnung zu Freibandpools ausgewählt werden. Außerdem kann die Auswahl der Bänder über ihre Zuordnung zu einer Domäne getroffen werden.

Der DA kann die Anweisung nur in der eigenen Domäne ausführen. Der Operand DOMAIN ist daher für ihn ohne Bedeutung.

Format

SHOW-VSNS

SELECT = *USER-ID ENTIFICATION (...) / *FILE-NAME(...) / *DIRECTORY-NAME(...) /
				*FREE-VOLUMES(...) / *VOLUME-GROUP(...)
	*USER-ID ENTIFICATION(...)
		|	USER-IDENTIFICATION = *ALL / <filename 1..8 with-wild>
	*FILE-NAME(...)
		|	FILE-NAME = *ALL / <filename 1..41 without-cat-user with-wild>
	*DIRECTORY-NAME(...)
		|	DIRECTORY-NAME = *ALL / <filename 1..54 without-gen-vers>
	*FREE-VOLUMES(...)
		|	DEVICE-TYPE = *STD / <structured-name 1..8>
		|	,FREE-POOL = *NO / *GLOBAL / *TSOS / <filename 1..54> /
					<text 2..32 without-sep>
	*VOLUME-GROUP(...)
		|	VOLUME-GROUP = *ALL / <text 1..32 without-sep>
,OUTPUT = *SYSOUT / *NONE
,STRUCTURE-OUTPUT = *NONE / <composed-name 1..255> (...)
	<composed-name 1..255> (...)
		|	WRITE-MODE = *REPLACE / *EXTEND
, DOMAIN = *ANY / *OWN / *STD-DOMAIN / <alphanum-name 1..8>
,INFORMATION = *VOL UMES / *SUMMARY

Operandenbeschreibung

SELECT =
Bestimmt die Auswahlkriterien für die auszugebenden Archivnummern und bestimmt damit gleichzeitig, nach welchen Kriterien die Ausgabe sortiert werden soll.

SELECT = *USER-IDENTIFICATION(...)
Die Ausgabe soll sortiert nach Benutzerkennungen erfolgen. Die Ausgabe kann auf bestimmte Benutzerkennungen beschränkt werden.

USER-IDENTIFICATION = *ALL / <filename 1..8 with-wild>
Es werden nur die Archivnummern aller für diese Benutzerkennung reservierten Bänder ausgegeben. Als letztes Zeichen der Benutzerkennung kann auch ein „*“ (z.B. TEST*) eingegeben werden. In diesem Fall werden die Archivnummern aller Benutzerkennungen mit den angegebenen Anfangszeichen (TEST) ausgewählt. Keine weiteren Musterzeichen außer „*“ sind erlaubt.

USER-IDENTIFICATION = *ALL
Es wird keine Auswahl bezüglich einer bestimmten Benutzerkennung getroffen.

SELECT = *FILE-NAME(...)
Die Ausgabe soll sortiert nach Dateinamen erfolgen. Die Ausgabe kann auf einen bestimmten Dateinamen beschränkt werden.

FILE-NAME = *ALL / <filename 1..41 with-wild-without-cat-user>
Es werden die Archivnummern von allen reservierten Bändern aufgelistet, die im Katalogeintrag den angegebenen Dateinamen enthalten. Als letztes Zeichen des Dateinamens kann auch ein „*“ (z.B. PROG*) eingegeben werden. In diesem Fall werden die Archivnummern zu allen Dateinamen mit den angegebenen Anfangszeichen (PROG) ausgewählt. Keine weiteren Musterzeichen außer „*“ sind erlaubt.

FILE-NAME = *ALL
Es wird keine Auswahl nach Dateinamen getroffen. Ausgenommen werden jedoch Bänder, die im Katalogeintrag keinen Dateinamen oder den Namen eines Directories enthalten.

SELECT = *DIRECTORY-NAME(...)
Die Ausgabe soll sortiert nach den Namen von Directories erfolgen.
Die Ausgabe kann auf ein bestimmtes Directory beschränkt werden.

DIRECTORY-NAME = *ALL / <filename 1..54 without-gen-vers>
Es werden nur reservierte Bänder ausgewählt, die dem angegebenen Directory zugeordnet sind.
Befindet sich das Directory unter einer fremden Benutzerkennung, so muss zusätzlich zur Benutzer- auch die Katalogkennung angegeben werden. Die eigene Benutzer- und Standardkatalogkennung können weggelassen werden.

DIRECTORY-NAME = *ALL
Ausgegeben werden die Archivnummern von allen reservierten Bändern, die den Pools von Directories zugeordnet sind.

SELECT = *FREE-VOLUMES(...)
Gibt an, dass nur die Archivnummern von freien Bändern ausgegeben werden sollen.

DEVICE-TYPE =
Gerätetyp. Wird beim Operanden FREE-POOL ein Directory-Name angegeben, so wird die Eingabe für DEVICE-TYPE ignoriert.

DEVICE-TYPE = *STD
Aufgelistet werden alle Bänder des Standard-Gerätetyps (DEFAULT-DEVICE-TYPE), dessen Wert bei der Anweisung MODIFY-MAREN-PARAMETERS angegeben wurde.

DEVICE-TYPE = <structured-name 1..8>
Gerätetyp. Zu den möglichen Angaben (abhängig von der BS2000-Version) siehe Handbuch „Systeminstallation“ [6].

FREE-POOL =
Nimmt eine Auswahl der auszugebenden Archivnummern bezüglich der Freibandpools vor.

FREE-POOL = *NO
Es werden nur freie Bänder ausgewählt, die dem Freibandpool *NO zugeordnet sind.

FREE-POOL = *GLOBAL
Es werden nur freie Bänder ausgewählt, die dem Freibandpool *GLOBAL zugeordnet sind.

FREE-POOL = *TSOS
Es werden nur freie Bänder ausgewählt, die dem Freibandpool *TSOS zugeordnet sind.

Werden die Werte *NO, *GLOBAL oder *TSOS verkürzt angegeben, so werden diese Operandenwerte aus Kompatibilitätsgründen auf ihre volle Länge expandiert (z.B. wird die Eingabe *GL auf *GLOBAL erweitert).

FREE-POOL = <filename 1..54 without-gen-vers>
Es werden nur freie Bänder ausgewählt, die dem Freibandpool für HSMS/ARCHIVE-Anwendungen unter Verwendung des hier angegebenen Directories zugeordnet sind. Befindet sich das Directory unter einer fremden Benutzerkennung, so muss zusätzlich zur Benutzer- auch die Katalogkennung angegeben werden. Die eigene Benutzer- und Standardkatalogkennung können weggelassen werden.

FREE-POOL = <text 2..32 without-sep>
Gibt den Namen eines Freibandpools an.
Der Freibandpool-Name muss mit * beginnen, danach muss mindestens ein Zeichen aus der Menge A..Z oder 0..9 folgen. Die Zeichen „.“, „-“ und „_“ sind erlaubt, allerdings nicht am Ende und nicht kombiniert hintereinander.

SELECT = *VOLUME-GROUP(...)
Die Ausgabe soll sortiert nach den Namen von Volume-Gruppen erfolgen.

VOLUME-GROUP = *ALL / <text 1..32 without-sep>
Es werden die Archivnummern von allen reservierten Bändern aufgelistet, die im Katalogeintrag die angegebene Volume-Gruppen enthalten. Bei der Angabe von *ALL werden alle reservierten Bänder ausgegeben, die explizit einer Volume-Gruppe zugeordnet sind. Als letztes Zeichen kann ein „*“ eingegeben werden. In diesem Fall werden alle Volume-Gruppen ausgewählt, die mit der angegebenen Zeichenfolge beginnen.

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.

DOMAIN =
Nur die Archivnummern von Bändern der angegebenen Domäne sollen ausgegeben werden.

DOMAIN = *ANY
Die Archivnummern von Bändern aller Domänen werden ausgegeben.

DOMAIN = *OWN
Die Archivnummern von Bändern der eigenen Domäne werden ausgegeben.
Die eigene Domäne ist die Domäne des Systems, an dem der ADA aktuell arbeitet.

DOMAIN = *STD-DOMAIN
Die Archivnummern von Bändern der Standard-Domäne werden ausgegeben.

DOMAIN = <alphanum-name 1..8>
Die Archivnummern von Bändern der ausgewählten Domäne werden ausgegeben.

Wenn mit Domänen gearbeitet wird, werden dem DA freie Bänder entweder aus der Standard-Domäne oder der eigenen Domäne angezeigt. Dies ist davon abhängig, welchen Wert der domänen-spezifische Operand FREE-VOLUMES hat.
Dem ADA werden freie Bänder derjenigen Domäne angezeigt, die mit dem Operand DOMAIN angegeben ist.

INFORMATION =
Bestimmt den Umfang der auszugebenden Informationen.

INFORMATION = *VOLUMES
Gibt an, dass sowohl die Archivnummern als auch die jeweilige Gesamtzahl aller Archivnummern pro Benutzerkennung, Dateiname usw. ausgegeben werden soll.

INFORMATION = *SUMMARY
Es soll nur die Gesamtzahl aller Archivnummern pro Benutzerkennung, Dateiname usw. ausgegeben werden.

Hinweise

• Gibt es zu einer Archivnummer mehrere Katalogeinträge mit unterschiedlichen Dateifolgenummern, so wird diese Archivnummer bei der betreffenden Benutzerkennung nur einmal ausgegeben.

• Bei einer Auswahl nach Dateinamen wird die Archivnummer auch bei einem Katalogeintrag mit einer Dateifolgenummer > 1 ausgegeben.

Beispiele

Beispiel 1: SYSOUT-Ausgabe für Bänder von Benutzerkennungen, die mit „SYS“ beginnen:

//show-vsns user-id=sys*
%  MARM1D1 VOLUMES FOR USER ID 'SYSDUMP' :
 MB2251
%  MARM1D6      1 VOLUMES FOR USER ID 'SYSDUMP'
%  MARM1D1 VOLUMES FOR USER ID 'SYSHSMS' :
 DRL1D6  TAR012  THS013
%  MARM1D6      3 VOLUMES FOR USER ID 'SYSHSMS'
%  MARM1D1 VOLUMES FOR USER ID 'SYSMAREN' :
 RHS002  THS014  TLS031  TLS032  TLS033  TLS034  TLS035  TLS036  TLS037
 TLS038  TLS039  TLS040  TLS041  TLS042  TLS043  TLS044  TLS045
%  MARM1D6     17 VOLUMES FOR USER ID 'SYSMAREN'
%  MARM1D1 VOLUMES FOR USER ID 'SYSROBAR' :
 TO7825
%  MARM1D6      1 VOLUMES FOR USER ID 'SYSROBAR'
%  MARM1D9 TOTAL OF     22 DATENTRAEGER IM MAREN-KATALOG ENTSPRECHEN DEN
AUSWAHL-KRITERIEN
%  MARM170 STATEMENT '//SHOW-VSNS' PROCESSED

Beispiel 2: SYSOUT-Ausgabe für Bänder nach Volume-Gruppen sortiert
(durch Angabe von SELECT=*VOLUME-GROUP(...)):

//show-vsns select=*volume-group(volume-group=epswos3*),information=*volumes
%  MARM290 VOLUMES FOR VOLUME-GROUP 'EPSWOS3-CLM':
 CLM020  CLM021  CLM023  CLM027  CLM028  CLM205
%  MARM291      6 VOLUMES FOUND FOR VOLUME-GROUP 'EPSWOS3-CLM'
%  MARM290 VOLUMES FOR VOLUME-GROUP 'EPSWOS3-GER':
 ANCA01  ANCA02  ANCA03  ANCA04  ANCA05  ANCA06  ANCA07
%  MARM291      7 VOLUMES FOUND FOR VOLUME-GROUP 'EPSWOS3-GER'
%  MARM1D9 TOTAL OF  13 VOLUMES IN MAREN CATALOG MATCH SPECIFIED SELECTION
CRITERIA
%  MARM170 STATEMENT '//SHOW-VSNS' PROCESSED

Über den Operanden INFORMATION=*VOLUMES werden die Archivnummern aller reservierten Bänder ausgegeben, die im Katalogeintrag einen Volume-Gruppennamen enthalten, der mit EPSWOS beginnt. Ferner wird die Gesamtzahl der Bänder aufgelistet, die dem angegebenen Auswahlkriterium genügen.

//show-vsns select=*volume-group(volume-group=epswos3*),information=*summary
%  MARM291     6 VOLUMES FOUND FOR VOLUME-GROUP 'EPSWOS3-CLM'
%  MARM291     7 VOLUMES FOUND FOR VOLUME-GROUP 'EPSWOS3-GER'
%  MARM1D9 TOTAL OF  13 VOLUMES IN MAREN CATALOG MATCH SPECIFIED SELECTION
CRITERIA
%  MARM170 STATEMENT '//SHOW-VSNS' PROCESSED

MIT INFORMATION=*SUMMARY wird nur die Gesamtzahl der Bänder ausgegeben, die im Katalogeintrag die Volume-Gruppe EPSWOS3* enthalten.

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“ [5].

Ausgabe-Information	Name der S-Variablen	T	Inhalt
Zugriffszähler (8-stellig), der bei jedem Zugriff auf das Band hochgezählt wird.	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 Directories (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	var(*LIST).F-NAME	S	<filename 1..41>
Freigabedatum des Bandes Gibt an, wann die Reservierung des Bandes für eine Benutzerkennung beendet ist.	var(*LIST).FREE-DATE	S	yyyy-mm-dd
Freigabe-Lagerort, an den ein Band beim so genannten Aufräumlauf verlagert wird.	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 Zugriff	var(*LIST).PASS	S	*NONE *YES
Bemerkungsfeld, das mit einem aussagekräftigen Text ausgefüllt werden soll.	var(*LIST).REMARK	S	<c-string 1..24>
Reservierungs-Zähler, der bei jeder Neureservierung des Bandes hochgezählt wird.	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 (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	var(*LIST).USER-ACCOUNT	S	<alphanum-name 1..8>
Benutzerfeld. Hier können solche Daten eingetragen werden, wie z.B. Name, Abteilung oder relevante Daten für die Arbeitsvorbereitung	var(*LIST).USER-FIELD	S	<c-string 1..54>
Benutzerkennung des Eigentü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