Diese Anweisung gibt Informationen aus dem MAREN-Katalog nach SYSOUT aus. Bei Eingabe einer einzelnen Archivnummer wird dessen kompletter Katalogeintrag ausgegeben. Bei Eingabe eines Nummernkreises oder bei *ALL wird eine Auswahl wichtiger Katalogeintragsfelder ausgegeben. Bei Angabe einer Ausgabedatei werden die vollständigen Katalogeinträge der angegebenen Bänder ausgegeben. Für eine Tabellenverarbeitung kann die Datei auch im CSV-Format erstellt werden. Außerdem kann auch vereinbart werden, dass die Datei nach der Erstellung per E-Mail verschickt wird.
Mit MAREN V12.6 wurde der neue Operand VOLUME-STATE eingeführt, der Bänder aus dem MAREN-Katalog anhand ihres Status auswählt.
Listen mit Informationen aus dem MAREN-Katalog erstellt die Anweisung PRINT-VOLUME-ATTRIBUTES, siehe "PRINT-VOLUME-ATTRIBUTES Listen mit Informationen aus dem MAREN-Katalog erstellen".
Format
| SHOW-VOLUME-ATTRIBUTES | Kurzname: SH / SHVA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1Der Operandenwert *V8.1-AND-LOWER ist obsolet. Er kann aus Kompatibilitätsgründen noch angegeben werden.
Operandenbeschreibung
VOLUME =
Archivnummern von Bändern, über die Informationen ausgegeben werden sollen.
VOLUME = *ALL
Bearbeitet werden alle Bänder.
VOLUME = *INTERVAL (...)
Bearbeitet werden alle Bänder, deren Archivnummer im angegebenen Bereich liegt.
FROM = *FIRST
Bearbeitet werden alle Bänder ab der kleinsten vorhandenen Archivnummer.
FROM = <vsn>
Archivnummer. Bearbeitet werden alle Bänder, deren Archivnummer größer oder gleich der angegebenen Archivnummer ist.
TO = *LAST
Bearbeitet werden alle Bänder bis zur größten vorhandenen Archivnummer.
TO = <vsn>
Archivnummer. Bearbeitet werden alle Bänder, deren Archivnummer kleiner oder gleich der angegebenen Archivnummer ist.
FROM-FSEQ = 1 / <integer 1..9999>
Dateifolgenummer des FROM-Operanden. Gibt den genauen Beginn der Bearbeitung an. Dieser Operand ist nur dann relevant, wenn die Anweisung über die MAREN-Programmschnittstelle eingegeben wird.
VOLUME = <vsn>(...)
Archivnummer des gewünschten Bandes.
FILE-SEQUENCE = 1 / <integer 1..9999>
Gibt an, welche Dateifolgenummer der betroffenen Archivnummern bearbeitet werden soll.
VOLUME-STATE =
Wählt Bänder anhand ihres Status aus.
VOLUME-STATE = *ALL
Bänder werden unabhängig von ihrem Status ausgewählt.
VOLUME-STATE = *FOREIGN / *PRIVATE
Es werden nur private Bänder ausgegeben. Dieses Band gehört nicht dem lokalen Rechenzentrum (,daher wird *FOREIGN synonym für *PRIVATE verwendet). Es wird von einem Benutzer über den Administrator in den MAREN-Katalog importiert, um für einen begrenzten Zeitraum im lokalen Rechenzentrum verarbeitet zu werden.
VOLUME-STATE = *RESERVED
Es werden nur reservierte Bänder ausgegeben. Wenn diese einer fremden Benutzerkennung zugeordnet sind, werden nur mehrbenutzbare Bänder angezeigt.
VOLUME-STATE = *EXPORTED
Es werden nur exportierte Bänder ausgegeben werden.
USER-IDENTIFICATION = *OWN / <name 1..8>
Angezeigt werden alle Katalogeinträge von Bändern, die dieser Benutzerkennung zugeordnet sind. Bei einer fremden Benutzerkennung werden nur die mehrfachbenutzbaren Bänder angezeigt.
USER-IDENTIFICATION = *OWN
Es werden nur Bänder der eigenen Benutzerkennung ausgewählt.
FILE-NAME =
Hier kann die Ausgabe auf Katalogeinträge mit einem bestimmten Dateinamen beschränkt werden.
FILE-NAME = *ALL
Es werden alle Katalogeinträge ausgegeben, die einen Dateinamen enthalten. Der voreingestellte Wert *ALL wird nur berücksichtigt, wenn im Operanden DIRECTORY-NAME *ALL oder *NONE angegeben ist.
FILE-NAME = *NONE
Katalogeinträge, die einen Dateinamen enthalten, werden nicht ausgegeben.
FILE-NAME = <filename 1..41 without-cat-user-gen-vers with-wild>(...)
Als letztes Zeichen des Dateinamens kann das Musterzeichen „*“ (z.B. PROG*) eingegeben werden. In diesem Fall werden die Katalogeinträge zu allen Dateinamen aufgelistet, welche mit der angegebenen Zeichenfolge (hier „PROG“) beginnen. Über den Operanden VOLUME kann bestimmt werden, mit welchem Band die Ausgabe beginnt.
VOLUME = *ANY / *NEXT(...)
Gibt an, mit welchem Band die Ausgabe beginnen soll. Die Angabe des Operanden ist erforderlich für die MAREN-Programmschnittstelle. Sie ermöglicht, dass jeder Katalogeintrag gelesen werden kann. Im Dialog kann das erste Band angegeben werden, mit dem die Ausgabe beginnen soll. Voreingestelllt ist *ANY, d.h. es werden alle Katalogeinträge für die Dateien ausgegeben, die der angegebenen Musterzeichenfolge entsprechen.
VOLUME = *NEXT(...)
Nach dem angegebenen Katalogeintrag werden alle bestehenden Katalogeinträge ausgegeben, deren Dateinamen der angegebenen Musterzeichenfolge entsprechen. Für die MAREN-Programmschnittstelle können somit alle Einträge aufgelistet werden. Der zuletzt gelesene Katalogeintrag muss über die Operanden FROM und FROM-FSEQ angegeben werden.
FROM = <vsn>
Archivnummer des ersten Bandes, mit dem die Ausgabe beginnen soll.
FROM-FSEQ = <integer 1..9999>
Dateifolgenummer, die mit der Archivnummer überstimmt.
FILE-NAME = <filename 1..41 without-cat-user-gen-vers>(...)
Es werden nur Katalogeinträge mit diesem Dateinamen ausgegeben.
VERSION =
Der Operand wird nur bei VOLUME=*ALL bzw. *INTERVAL ausgewertet. Mit diesem Operand kann für die angegebene Datei eine bestimmte Version (bzw. Dateistand) ausgewählt werden, zu der die dazugehörigen Bänder ausgegeben werden sollen.
VERSION = *ALL
Zu dem angegebenen Dateinamen werden sämtliche vorhandenen Versionen ausgegeben.
VERSION = *LATEST
Es wird die neueste (zuletzt erzeugte) Dateiversion ausgewählt.
VERSION = <integer -9999..0>
Angabe 0 entspricht der Angabe *LATEST, Angabe -1 bedeutet vorletzter Dateistand usw.
VERSION = *NOT-CREATED
Es werden nur solche Bänder ausgewählt, die zwar mit dem angegebenen Dateinamen reserviert, aber nicht beschrieben wurden (Katalogeintragsfelder CREATION-DATE und CREATION-TIME sind unbesetzt). Der bei TYPE-OF-VOLUMES angegebene Wert ist in diesem Fall ohne Bedeutung und wird nicht ausgewertet.
TYPE-OF-VOLUMES =
Dieser Operand bezieht sich auf die Bandfolgenummern (Katalogeintragsfeld VOLUME-SEQUENCE) innerhalb eines Tape-Sets. Diese Nummern sind normalerweise eindeutig. Nach einem Restart können jedoch einzelne Nummern doppelt vorhanden sein.
Bei folgenden Angaben wird der Operand TYPE-OF-VOLUMES nicht ausgewertet:
VERSION = *NOT-CREATED;
VOLUME = <vsn>.
TYPE-OF-VOLUMES = *ANY
Die Bandfolgenummern für ein Tape-Set werden nicht auf mehrfaches Vorkommen untersucht.
TYPE-OF-VOLUMES = *VALID(...)
Bei mehrfach vorkommenden Bandfolgenummern werden für ein Tape-Set immer nur die zuletzt erstellten ausgewählt.
CLOSE-CHECK =
Mit diesem Operand kann man wählen, ob das Katalogeintragsfeld CLOSE-INDICATOR ausgewertet werden soll.
Bei folgenden Angaben wird der Operand CLOSE-CHECK nicht ausgewertet:
VERSION = *NOT-CREATED;
VOLUME = <vsn>.
CLOSE-CHECK = *NO
Das Katalogeintragsfeld CLOSE-INDICATOR wird nicht ausgewertet.
CLOSE-CHECK = *YES
Wenn bei einem Band des ausgewählten Tape-Sets das Katalogeintragsfeld CLOSE-INDICATOR nicht auf CLOSED steht, wird die Anweisung abgebrochen.
TYPE-OF-VOLUMES = *OBSOLETE
Bei mehrfach vorhandenen Bandfolgenummern für ein Tape-Set werden alle bis auf die zuletzt erstellten ausgewählt.
DIRECTORY-NAME =
Es werden nur 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 Benutzerkennung und die Standardkatalogkennung können weggelassen werden.
DIRECTORY-NAME = *ALL(...)
Es werden alle Katalogeinträge ausgegeben, die den Namen eines Directory enthalten. Der voreingestellte Wert *ALL wird nur berücksichtigt, wenn der Operand FILE-NAME mit *ALL oder *NONE angegeben ist.
DIRECTORY-ON-VOLUME = *ANY / *YES
Gibt an, ob die Ausgabe beschränkt werden soll auf Bänder, die am Bandende ein Directory enthalten. Mit der Voreinstellung *ANY werden Bänder unabhängig von einem darauf enthaltenen Directory angezeigt.
DIRECTORY-NAME = *NONE
Katalogeinträge, die den Namen eines Directory enthalten, werden nicht ausgegeben.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
Name des Directories.
VOLUME-STATUS =
Nimmt eine Auswahl der dem angegebenen Directory zugeordneten Bänder bezüglich ihres Status vor.
VOLUME-STATUS = *RESERVED(...)
Nur reservierte Bänder sollen ausgegeben werden. Sind diese einer fremden Benutzerkennung zugeordnet, so werden davon nur die mehrbenutzbaren Bänder angezeigt.
SAVE-FILE-ID =
Die auszugebenden Bänder werden über die Sicherungsdatei des angegebenen Directory ausgewählt.
SAVE-FILE-ID = *ALL
Alle Bänder aus diesem Directory sollen ausgegeben werden.
SAVE-FILE-ID = *LATEST
Alle Bänder, die in der letzten, d.h. jüngsten Sicherungsdatei verzeichnet sind, werden ausgewählt.
SAVE-FILE-ID = <integer -32767..0>
Alle Bänder, die in der n-ten Sicherungsdatei (wobei n mit dem Alter der Sicherungsdatei aufsteigt) verzeichnet sind, werden ausgewählt. 0 ist gleichbedeutend mit *LATEST. Beispiel: Bei Angabe von -5 werden die Bänder aus der fünftneuesten Sicherungsdatei ausgewählt.
SAVE-FILE-ID = <composed-name 15..15>
Alle Bänder einer Sicherungsdatei mit der spezifizierten SAVE-FILE-ID werden ausgewählt. Die SAVE-FILE-ID wird wie folgt angegeben: S.yymmdd.hhmmss.
DIRECTORY-ON-VOLUME = *ANY / *YES
Gibt an, ob die Ausgabe beschränkt werden soll auf Bänder, die am Bandende ein Directory enthalten. Mit der Voreinstellung *ANY werden Bänder unabhängig von einem darauf enthaltenen Directory angezeigt.
VOLUME-STATUS = *FREE
Es sollen nur Bänder ausgegeben werden, die sich noch im HSMS/ARCHIVE-Freibandpool von MAREN für das betreffende Directory befinden, also für künftige HSMS/ARCHIVE-Sicherungen unter Verwendung dieser Directories zur Verfügung stehen. Der Operand USER-IDENTIFICATION wird nicht ausgewertet.
VOLUME-GROUP = *ANY / *NONE / <text 1..32 without-sep>
Es werden nur Bänder ausgegeben, die der angegebenen Volume-Gruppe zugeordnet sind. Bei der Angabe von *ANY spielt die Volume-Gruppe, der das Band angehört, keine Rolle. Bei *NONE darf das Band keiner Volume-Gruppe zugeordnet sein. Als letztes Zeichen kann ein „*“ eingegeben werden. In diesem Fall werden alle Volume-Gruppen ausgewählt, die mit der angegebenen Zeichenfolge beginnen.
HOME-LOCATION =
Lagerortname oder symbolischer Lagerortname.
HOME-LOCATION = *ALL
Bearbeitet werden alle Dauer-Lagerorte.
HOME-LOCATION = <alphanum-name 1..8>
Bearbeitet werden alle Katalogeinträge mit dem angegebenen Dauer-Lagerort.
DEVICE-TYPE =
Gerätetyp.
DEVICE-TYPE = *ALL
Katalogeinträge aller Gerätetypen werden ausgegeben.
DEVICE-TYPE = *STD
Aufgelistet werden alle Bänder mit dem vom MAREN-Administrator festgelegten Standard-Gerätetyp.
DEVICE-TYPE = <structured-name 1..8>
Gerätetyp. Zu den möglichen Angaben (abhängig von der BS2000-Version) siehe Handbuch „Systeminstallation“ [6].
OUTPUT =
Bestimmt das Ausgabemedium.
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).
OUTPUT = <filename 1..54>
Nur für die Angabe einer Dateigeneration.
Die Ausgabe erfolgt im MAREN-Format in die angegebene Dateigeneration. Dabei werden Kennwörter mit C'$$$$' überschrieben. Auf SYSOUT wird nur die Anzahl der geschriebenen Sätze angezeigt.
OUTPUT = <filename 1..54 without-gen-vers>(...)
Name der SAM-Ausgabedatei, in die alle ausgewählten Katalogeinträge geschrieben werden sollen. Dabei werden Kennwörter mit C'$$$$' überschrieben. Auf SYSOUT wird nur die Anzahl der geschriebenen Sätze angezeigt. Zusätzlich kann das Ausgabeformat und der Versand der Datei per E-Mail festgelegt werden.
FORMAT =
Bestimmt das Format der Ausgabedatei.
FORMAT = *MAREN-STRUCTURE
Die Ausgabe erfolgt im MAREN-Format.
FORMAT = *CSV(...)
Die Ausgabe erfolgt im CSV-Format (comma separated value). Dateien im CSV-Format lassen sich spaltengerecht einlesen und mit einem Tabellenverarbeitungsprogramm (z.B. EXCEL) weiterverarbeiten.
SEPARATOR = *SEMICOLON / *COMMA
Bestimmt das Trennzeichen, das zwischen die einzelnen Ausgabewerte gesetzt werden soll. Das voreingestellte Trennzeichen ist das Semikolon (;). Optional kann auch das Komma (,) als Trennzeichen vereinbart werden.
HEADER-LINE = *YES / *NO
Gibt an, ob eine Überschriftszeile zur Bezeichnung der Ausgabespalten ausgegeben werden soll. Voreingestellt ist *YES, d.h. es wird eine Überschriftszeile ausgegeben. Die Überschriftszeile enthält die Namen der Katalogeintragsfelder.
SEND-BY-MAIL = *NO / *YES(...)
Gibt an, ob die die Ausgabedatei per E-Mail verschickt werden soll. Voreingestellt ist *NO, d.h. es erfolgt kein Versand per E-Mail. Das Versenden per E-Mail erfolgt nur, falls die zu versendende Datei mindestens einen Eintrag enthält.
SEND-BY-MAIL = *YES(...)
Die Ausgabedatei soll im Anhang einer E-Mail verschickt werden. Der Empfänger wird über seine Benutzerkennung adressiert, d.h. die E-Mail-Adresse wird dem entsprechenden Benutzereintrag entnommen.
TO = *USER(...)
Angaben zum Versand der E-Mail:
USER-IDENTIFICATION = *OWN / <name 1...8>
Angabe der Benutzerkennung. Aus diesem Benutzereintrag wird die Mail-Adresse des Empfängers übernommen. Wenn der Benutzereintrag mehrere Mail-Adressen enthält, werden alle Adressen als Empfänger übernommen. Voreingestellt ist *OWN, d.h. die Benutzerkennung des Aufrufers.
SUBJECT = *STD /<c-string 1...256>
Bestimmt den Inhalt des „Betreff“-Feldes der E-Mail. Voreinstgestellt ist *STD, d.h. MAREN verwendet einen Standardtext.
DELETE-FILE = *NO / *YES / *DESTROY
Gibt an, ob die Datei nach dem Versenden automatisch gelöscht werden soll. Voreingestellt *NO, d.h. die Datei wird nicht gelöscht. Mit *YES wird die Datei nach dem Versenden gelöscht. Mit *DESTROY wird sie ebenfalls gelöscht und der Speicherplatz mit binär null überschrieben.
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.
OVERFLOW-CONTROL =
Art der Steuerung bei Bildschirmüberlauf im Dialog.
OVERFLOW-CONTROL = *BY-PROGRAM
Steuerung durch das Programm: Nach der Verarbeitung von jeweils 18 Katalogeinträgen erfolgt eine Abfrage, ob die laufende Aktion fortgesetzt oder abgebrochen werden soll.
OVERFLOW-CONTROL = *BY-SYSTEM
Steuerung durch BS2000: Die Art der Steuerung bei Bildschirmüberlauf richtet sich nur nach dem Systemparameter TCHOFLO bzw. nach dem mit dem Kommando MODIFY-TERMINAL-OPTIONS eingestellten Wert.
INFORMATION =
Bei Einzelangabe eines Bandes bestimmt dieser Operand das Ausgabeformat für die Ausgabe nach SYSOUT.
INFORMATION = *STD
Das Ausgabeformat wird aus den MAREN-Parametern bestimmt, falls nicht durch eine vorhergehende Angabe (SHOW-INFORMATION=NORMAL, MAXIMUM) das Standard-Format für den aktuellen Programmlauf geändert wurde.
INFORMATION = *NORMAL
Die Ausgabe enthält die wichtigsten Informationen. Die Ausgabe ist nicht garantiert und kann sich in höheren Versionen wieder ändern. Wurde *NORMAL angegeben, so wird dies bis zum Neuladen des Programms neuer Standard.
INFORMATION = *MAXIMUM
Die Ausgabe enthält alle Informationen. Die Ausgabe ist nicht garantiert und kann sich in höheren Versionen wieder ändern. Wurde *MAXIMUM angegeben, so wird dies bis zum Neuladen des Programms neuer Standard.
Hinweise
Bei den Operanden FILE-NAME und DIRECTORY-NAME darf immer nur bei einem Operanden ein Operandenwert ungleich der Voreinstellung *ALL angegeben werden.
Mithilfe des Operanden VOLUME-STATUS = *FREE hat man die Möglichkeit, sich vor dem Start einer HSMS/ARCHIVE-Sicherung zu vergewissern, ob noch eine ausreichende Anzahl von Bändern für Sicherungsläufe mit diesem Directory zur Verfügung stehen. Sinnvoll ist die Angabe dieses Operanden aber nur dann, wenn der MAREN-Administrator auch tatsächlich einen HSMS/ARCHIVE-Freibandpool für dieses Directory eingerichtet hat. Dies geschieht in der Regel nur auf Grund einer Benutzeranforderung.
Falls bei der Angabe einer einzelnen Archivnummer diese im MAREN-Katalog nicht gefunden oder wenn bei Angabe eines Nummernkreises in diesem Bereich kein Katalogeintrag gefunden wird, dann wird die Anweisung mit einer Fehlermeldung abgebrochen und Spin-off ausgelöst.
Bei Einzelangabe wird bei PASSWORD nur YES oder NONE ausgegeben, fremde Benutzerkennungen und deren Abrechnungsnummern werden durch „$“ ersetzt.
Die Angabe erfolgt dabei im Dialogbetrieb standardmäßig in Form einer einzigen Bildschirmmaske, im Batchbetrieb dagegen immer zeilenweise. Durch Setzen des Auftragsschalters 5 kann bewirkt werden, dass auch im Dialogbetrieb die Angabe zeilenweise vorgenommen wird. Dadurch wird eine bessere Lesbarkeit der Katalogeinträge in SYSOUT-Protokollen erreicht.Erscheint bei einer Nummernkreis-bezogenen Angabe eine FSEQ-Nummer = *001, so handelt es sich hierbei um ein temporär gesperrtes Band.
Die Angabe einer einzelnen Archivnummer wird abgewiesen, wenn sie zusammen mit FILE-NAME=<filename...>(..) angegeben wird, und für die Operanden VERSION und TYPE-OF-VOLUMES andere Werte als die Standardwerte verwendet werden.
Bei der Ausgabe einer Liste von Bändern erscheint die Spalte VOLUME GROUP nur, wenn der Operand VOLUME-GROUP Musterzeichen enthält. Wenn zusätzlich ein weiterer Selektionsoperand angegeben wurde, wird unter Umständen ein anderes Ausgabe-Layout bevorzugt.
Der Name der Volume-Gruppe wird bei einer Länge von mehr als 28 Zeichen durch einen Stern an Stelle 28 abgekürzt.
Beispiele
Beispiel 1: Ausgabe eines einzelnen MAREN-Katalogeintrags
|
Informationsausgabe mit allen Informationen.
Beispiel 2: Ausgabe aller Bänder der eigenen Benutzerkennung
|
Bedeutung der Katalogeintragsfelder:
VOLUME FSEQ DEV-TYPE CR-DATE L-A-DATE FREE-DATE UA E REMARK | Archivnummer Dateifolgenummer Gerätetyp Erstellungsdatum letzter Zugriff Freigabedatum; ist kein Datum eingetragen, handelt es sich um ein fremdes Band USER-ACCESS - wird mit folgenden Werten angezeigt:
Leihvermerk Ein ausgeliehenes Band wird mit „E“ (EXPORTED) gekennzeichnet Bemerkungsfeld (nur die ersten 20 Zeichen) |
Beispiel 3: Ausgabe aller Bänder zu bestimmten Dateinamen
|
Bedeutung der Katalogeintragsfelder:
VOLUME FSEQ CR-DATE CR-TIME CR-JOB 1STVSN VSEQ FILE/DIR-NAME | Archivnummer Dateifolgenummer Erstellungsdatum Erstellungsuhrzeit Erstellungsjobname Erste Archivnummer des MF/MV-Sets Dateiabschnittsnummer Datei bzw. Directoryname (nur die ersten 26 Zeichen) |
Beispiel 4: Ausgabe aller MAREN-Katalogeinträge eines Directory mit einer bestimmten SAVE-FILE-ID
|
Die Informationen zu allen Bändern, die in der letzten, d.h. jüngsten Sicherungsdatei verzeichnet sind, werden ausgegeben.
Beispiel 5: Ausgabe aller Bänder zu einer bestimmten Volume-Gruppe
|
Für ein Archivnummern-Intervall werden die Bänder ausgegeben, die den Volume-Gruppen EPSWOS3* angehören. Der Name der Volume-Gruppe wird bei einer Länge von mehr als 28 Zeichen durch einen Stern an Stelle 28 abgekürzt.
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].
Abhängig vom Operanden VOLUME werden folgende S-Variablen angelegt:
Angabe im Operanden VOLUME | gekürzte Schreibweise in Tabelle, Spalte Bedingung |
VOLUME=<vsn> (ein Band) | 1 |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
Zugriffszähler (8-stellig) | var(*LIST).ACCESS-COUNT | S | <integer 0..99999999> | 1,2 |
CLOSE-Indikator | var(*LIST).CLOSE-INDICATOR | S | OPENED | 1 |
Katalogkennung aus dem Dateinamen zum Zeitpunkt der Dateierstellung. Sie wird nur versorgt, wenn F-NAME existiert | var(*LIST).CRE-CAT-ID | S | <cat-id> | 1 |
Erstellungsdatum | var(*LIST).CRE-DATE | S | yyyy-mm-dd | 1,2 |
Erstellungs-Jobname | var(*LIST).CRE-JOB-NAME | S | ’’ | 1,2 |
Erstellungsuhrzeit | var(*LIST).CRE-TIME | S | hh:mm:ss | 1,2 |
Benutzerkennung aus dem Dateinamen zum Zeitpunkt der Dateierstellung. Sie wird nur versorgt, wenn F-NAME existiert. | var(*LIST).CRE-USER-ID | S | ’’ | 1 |
Gerätetyp | var(*LIST).DEV-TYPE | S | <structured-name 1..8> | 1,2 |
Name eines Directory (mit Katalog- und Benutzerkennung), in dem das Band enthalten ist. | var(*LIST).DIR-NAME | S | <filename 1..54> | 1,2 |
Anzeige, ob das Band das mitgesicherte Directory enthält | var(*LIST).DIR-ON-VOL | S | *NO | 1,2 |
Datei-Freigabedatum | var(*LIST).EXPIR-DATE | S | yyyy-mm-dd | 1 |
Versandanschrift. Bei der Anweisung EXPORT-VOLUME kann hier z.B. eine Versandanschrift eingetragen werden | var(*LIST).EXPORT-ADDR | S | <c-string 1..50> | 1 |
Ausleihdatum | var(*LIST).EXPORT-DATE | S | yyyy-mm-dd | 1 |
Zustand (exportiert oder nicht) | var(*LIST).EXPORTED | S | *NO | 1,2 |
Dateiname einer Banddatei | var(*LIST).F-NAME | S | <filename 1..41> | 1,2 |
Dateifolgenummer (4-stellig) | var(*LIST).F-SEQ | S | <integer 1..9999> | 1,2 |
Erste Archivnummer des MF/MV-Sets | var(*LIST).FIRST-VOL | S | <vsn> | 1,2 |
Freigabedatum des Bandes | var(*LIST).FREE-DATE | S | yyyy-mm-dd | 1,2 |
Freigabe-Lagerort | var(*LIST).FREE-LOCATION | S | <alphanum-name 1..8> | 1,2 |
Name des Freibandpools, in dem sich dieses Band befindet, bzw. bei seiner Freigabe befinden soll | var(*LIST).FREE-POOL | S | <filename 1..54> | 1,2 |
Standard-Lagerort | var(*LIST).HOME-LOCATION | S | <alphanum-name 1..8> | 1,2 |
Initialisierungskennzeichen | var(*LIST).INIT | S | YES | 1 |
Abrechnungsnummer des letzten Zugriffs | var(*LIST).LAST-ACCESS- | S | <alphanum-name 1..8> | 1 |
Datum des letzten Zugriffs | var(*LIST).LAST-ACCESS-DATE | S | yyyy-mm-dd | 1,2 |
Name des Systems mit dem letzten Zugriff | var(*LIST). | S | <alphanum-name 1..8> | 1,2 |
Auftragsname des letzten Zugriffs | var(*LIST). | S | <name 1..8> | 1 |
Uhrzeit des letzten Zugriffs | var(*LIST).LAST-ACCESS-TIME | S | hh:mm:ss | 1 |
TSN des letzten Zugriffs | var(*LIST).LAST-ACCESS-TSN | S | <alphanum-name 1..4> | 1 |
Benutzerkennung des letzten Zugriffs | var(*LIST).LAST-ACCESS-USER-ID | S | <name 1..8> | 1,2 |
Session-Nummer des letzten Zugriffs | var(*LIST).LAST-ACC-SESSION-NR | S | <integer 1..255> | 1 |
CLOSE-Datum | var(*LIST).LAST-CLOSE-DATE | S | yyyy-mm-dd | 1 |
CLOSE-Uhrzeit | var(*LIST).LAST-CLOSE-TIME | S | hh:mm:ss | 1 |
Blockzähler für das Band | var(*LIST).LAST-WRT-BLOCK-CNT | S | <integer | 1 |
OPEN-Typ des letzten Zugriffs | var(*LIST).OPEN-MODE | S | INPUT | 1 |
Kennwort für den Zugriff | var(*LIST).PASS | S | *NONE | 1,2 |
Bemerkungsfeld | var(*LIST).REMARK | S | <c-string 1..24> | 1,2 |
Frei versorgbares Bemerkungsfeld | var(*LIST).REMARK-2 | S | <c-string 1..10> | 1 |
Frei versorgbares Bemerkungsfeld | var(*LIST).REMARK-3 | S | <c-string 1..12> | 1 |
Reservierungs-Zähler (4-stellig) | var(*LIST).RESERV-COUNT | S | <integer 0..9999> | 2 |
Archivierungsdatum | var(*LIST).RESERV-DATE | S | yyyy-mm-dd | 1,2 |
SAVE-FILE-ID (HSMS) oder SAVE-VERSION-ID (ARCHIVE) | var(*LIST).SFID | S | <c-string 1..15> | 1,2 |
Nummer der Subtask für den parallelen Sicherungslauf in HSMS | var(*LIST).SUBSAVE | S | <integer 0..15> | 1,2 |
Nummer des Folgebands innerhalb eines parallelen Sicherungslaufs in HSMS | var(*LIST).SUBSEQ | S | <integer 0..999> | 1,2 |
Aktueller Lagerort | var(*LIST).TEMP-LOCATION | S | ’’ | 1 |
Mehrbenutzbarkeit des Bandes | var(*LIST).USER-ACCESS | S | OWNER-ONLY | 1,2 |
Abrechnungsnummer des Bandeigentümers | var(*LIST).USER-ACCOUNT | S | <alphanum-name 1..8> | 1,2 |
Benutzerfeld. Hier können beliebige Daten eingetragen werden, z.B. Name, Abteilung, | var(*LIST).USER-FIELD | S | <c-string 1..54> | 1,2 |
Benutzerkennung des Bandeigentümers | var(*LIST).USER-ID | S | <name 1..8> | 1,2 |
Archivnummer des Bandes | var(*LIST).VOL | S | <vsn> | 1,2 |
Volume-Gruppe | var(*LIST).VOL-GROUP | S | <text 1..32> | 1,2 |
Bandabschnittsnummer (4-stellig) | var(*LIST).VOL-SEQ | S | <integer 1..255> | 1,2 |
Bandstatus | var(*LIST).VOL-STA | S | FREE | 1 |
Bandstatus | var(*LIST).VOL-STA-1 | S | F/P/R/D | 2 |