Berechtigung ADA, DA, Administrator ohne Domänen
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 dem in MAREN V12.6 eingeführten Operanden VOLUME-STATE, können Bändern aus dem MAREN-Katalog anhand ihres Status selektiert werden.
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".
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-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, weshalb *FOREIGN synonym für *PRIVATE verwendet wird. Ein Benutzer veranlasst über den Administrator den Import in den MAREN-Katalog, 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 gemeinsam nutzbare Bänder angezeigt.
VOLUME-STATE = *EXPORTED
Es werden nur exportierte Bänder ausgegeben werden.
USER-IDENTIFICATION = *ALL / <filename 1..8 with-wild>
Angezeigt werden alle Katalogeinträge von Bändern, die dieser Benutzerkennung zugeordnet sind. Als letztes Zeichen der Benutzerkennung kann auch das Musterzeichen „*“ (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 der Benutzerkennung getroffen.
DOMAIN =
Legt die Domäne fest, zu deren Bänder Informationen ausgegeben werden.
DOMAIN = *ANY
Auswahl aller Domänen.
DOMAIN = *OWN
Es wird die eigene Domäne ausgewählt.
Die eigene Domäne ist die Domäne des Systems, an dem der ADA aktuell arbeitet, oder die Domäne, in der er die DA-Rolle übernommen hat.
DOMAIN = *STD-DOMAIN
Es wird die Standard-Domäne ausgewählt.
DOMAIN = <alphanum-name 1..8>
Es wird die angegebene Domäne ausgewählt.
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.
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 welcher Archivnummer 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.
Voreingestellt 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 =
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.
Dieser Operand wird nicht ausgewertet, falls bei VOLUME eine einzelne Archivnummer oder beim Operanden USER-ID das Musterzeichen „*“ angegeben wurde.
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>
Benutzerkennung bei USER-IDENTIFICATION mit Musterzeichen „*“
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>
Benutzerkennung bei USER-IDENTIFICATION mit Musterzeichen „*“.
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 Directories enthalten. Der voreingestellte Wert *ALL wird nur berücksichtigt, wenn im Operanden FILE-NAME *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 Directories enthalten, werden nicht ausgegeben.
DIRECTORY-NAME = <filename 1..54 without-gen-vers> (...)
Es werden nur Bänder aus diesem Directory ausgewählt. Die Selektion kann bereits mit dem Operanden VOLUME eingeschränkt worden sein. Die Ausgabe erfolgt aufsteigend nach SUB-SAVE-NUMBER und SUB-SEQUENCE-NUMBER (nicht nach Archivnummer sortiert)
SAVE-FILE-ID =
Die auszugebenden Bänder werden über die Sicherungsdatei des oben angegebenen Directories 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.
FREE-POOL =
Nimmt eine Auswahl der auszugebenden Katalogeinträge bezüglich der Freibandpools vor.
FREE-POOL = *ALL
Es wird keine Auswahl bezüglich eines bestimmten Freibandpools getroffen.
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.
FREE-POOL = <filename 1..54 without-gen-vers>
Es werden nur 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. Als letztes Zeichen kann ein „*“ eingegeben werden. In diesem Fall werden die Katalogeinträge zu allen Freibandpools aufgelistet, die mit der angegebenen Zeichenfolge beginnen. Die ausgewählten Sortierkriterien gelten dann nur innerhalb der einzelnen Freibandpools.
HOME-LOCATION =
Lagerortname oder symbolischer Lagerortname. Bearbeitet werden alle Katalogeinträge mit dem angegebenen Dauer-Lagerort.
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 = *ALL-TAPES
Aufgelistet werden Katalogeinträge aller Bänder.
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].
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 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 wie z.B.
MARENADM STATEMENT SHOW-VOLUME-ATTRIBUTES, FILENAME: <filename>
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.
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 die Katalogeinträge zu allen Volume-Gruppen aufgelistet, die mit der angegebenen Zeichenfolge beginnen.
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.
Bei der Angabe eines Nummernkreises mit dem Operand FILE-NAME=*ALL (Standardwert) wird von jedem betroffenen Band nur der Katalogeintrag mit der ersten FSEQ angezeigt. Wurde bei FILE-NAME eine andere Angabe als *ALL gemacht, so werden alle betreffenden FSEQs ausgegeben. Die Angabe von FILE-NAME=* und USER-ID=*ALL bewirkt wiederum nur die Ausgabe der ersten FSEQ eines Bandes.
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 Spin-off ausgelöst.
Der Inhalt des Katalogeintragsfeldes PASSWORD erscheint nur unter der Benutzerkennung TSOS im Klartext. Sonst wird nur YES oder NONE ausgegeben.
Zu beachten ist, dass bei Verwendung von Musterzeichen längere Wartezeiten bei der Bildschirmausgabe auftreten können, speziell dann, wenn nur wenige Katalogeinträge die angegebenen Auswahlkriterien erfüllen.
Bei Angabe einer einzelnen Archivnummer werden alle Katalogeintragsfelder gezeigt. 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 Ausgabe zeilenweise geschieht. Dadurch wird eine bessere Lesbarkeit der Katalogeinträge in SYSOUT-Protokollen erreicht.
Die Angabe einer einzelnen Archivnummer wird abgewiesen, wenn sie zusammen mit dem Parameter FILE-NAME=<filename>(...) angegeben wird und für dessen 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 ist, wird MAREN-intern unter Umständen ein anderes Ausgabe-Layout bevorzugt.
Beispiele
Beispiel 1: Ausgabe eines einzelnen MAREN-Katalogeintrages
|
Informationsausgabe mit den wichtigsten Informationen.
//show-volume-attributes volume=hlsQ13,inf=*maximum
VOLUME = HLSQ13 FILE-SEQ = 0001 DEV-TYPE = TAPE-C5 USER-ID = TSOS HOME-LOCATION = VTLSLOC RESERV-DATE = <date> ACCOUNT = ADMINSTR FREE-LOCATION = VTLSLOC FREE-DATE = <date> USER-ACC = OWNER-ONLY TEMP-LOCATION = VTLSLOC EXPIR-DATE = EXPORT = C' ' / USER-FIELD= C' ' DIR-NAME = :3V06:$TSOS.ARC.DIR.2 SAVE-FILE = SUBSAVE/SEQ = / REQUEST-NAME = BS15FROFREE-POOL = *NO VOL-SEQ = 0001 CR-DATE = LAST-ACC-DATE = CLOSE-IND = LAST-CL-DATE = LAST-ACC-USER-ID = INIT = NO REG-DATE = LAST-ACC-JOB-NAME = ADM-FIELD = C' ' /2 = C' ' LAST-ACC-TSN = LAST-WRITE-BLK-CNT = DEV-NAME = RESERV-COUNT = 0058 LAST-ACC-FUN-NAME = MODIFY DOMAIN = *STD-DOM DIR-ON-VOL = |
Informationsausgabe mit allen Informationen.
Beispiel 2: Ausgabe eines Nummernkreises von Bändern
//show-volume-attributes
volume=*interval(from=id5000,to=id6000)
----------------------------------------------------------------------------- VOLUME FSEQ DEV-TYPE USER-ID ACCOUNT RES-DATE FREE-DATE HOME-LOC ACC# E FL ----------------------------------------------------------------------------- ID5001 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0001 R ID5002 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0000 R ID5003 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0015 R ID5004 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0004 R ID5005 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0000 R ID5006 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0008 E R ID5007 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0000 R ID5008 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0021K R ID5009 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0014 R ID5010 0001 TAPE-C4 USER1 ACC2 <date> <date> CENTRAL 0000 R ID5011 0001 TAPE-C4 USER2 ACC081 <date> <date> CENTRAL 0000 R ID5012 0001 TAPE-C4 USER2 ACC081 <date> <date> CENTRAL 0000 R ID5013 0001 TAPE-C4 USER2 ACC081 <date> <date> CENTRAL 0000 R ID5014 0001 TAPE-C4 USER2 ACC081 <date> <date> CENTRAL 0045 R ID5015 0001 TAPE-C4 USER2 ACC081 <date> <date> CENTRAL 0002M R % MARM120 TOTAL OF 15 MAREN CATALOG ENTRIES PROCESSED |
Bedeutung der Ausgabefelder:
| VOLUME | VOLUME | |
| FSEQ | Dateifolgenummer Temporär gesperrte Bänder werden mit FSEQ='*001' ausgegeben. | |
| DEV-TYPE | Gerätetyp | |
| USER-ID | Benutzerkennung | |
| ACCOUNT | Abrechnungsnummer | |
| RES-DATE | Reservierungsdatum | |
| FREE-DATE | Freigabedatum | |
| HOME-LOC | Dauer-Lagerort | |
| ACC# | Zugriffszähler Werte von 10.000 bis 999.999 werden mit 10K bis 999K dargestellt, größere Werte mit 1M bis 99M | |
| E | Kennzeichen für ausgeliehene Bänder (E = EXPORTED) | |
F | Bandstatus, kann folgende Werte anzeigen: | |
R, F, P | kennzeichnet reserviert, frei, fremd | |
Beispiel 3: Ausgabe aller Bänder, deren Dateiname mit einer bestimmten Zeichenfolge beginnt
----------------------------------------------------------------------------- VOLUME FSEQ CR-DATE CR-TIME CR-JOB 1STVSN VSEQ USER-ID FILE-NAME(SHORT.) ----------------------------------------------------------------------------- GRA001 0001 <date> <time> MAREN001 GRA001 0001 MAREN001 SAMPLE.TAPESET.1 GRA002 0001 <date> <time> MAREN001 GRA002 0001 MAREN001 SAMPLE.TAPESET.1 GRA003 0001 <date> <time> MAREN001 GRA003 0001 MAREN001 SAMPLE.TAPESET.1 GRA004 0001 <date> <time> MAREN001 GRA003 0002 MAREN001 SAMPLE.TAPESET.1 GRA005 0001 <date> <time> MAREN001 GRA003 0003 MAREN001 SAMPLE.TAPESET.1 GRA006 0001 <date> <time> MAREN001 GRA006 0001 MAREN001 SAMPLE.TAPESET.1 GRA007 0001 <date> <time> MAREN001 GRA006 0002 MAREN001 SAMPLE.TAPESET.1 GRA008 0001 <date> <time> MAREN001 GRA006 0003 MAREN001 SAMPLE.TAPESET.1 GRA009 0001 <date> <time> MAREN001 GRA009 0001 MAREN001 SAMPLE.TAPESET.1 GRA010 0001 <date> <time> MAREN001 GRA003 0001 MAREN001 SAMPLE.TAPESET.1 GRA001 0002 <date> <time> MAREN001 GRA001 0001 MAREN001 SAMPLE.TAPESET.2 GRA002 0002 <date> <time> MAREN001 GRA002 0001 MAREN001 SAMPLE.TAPESET.2 GRA001 0003 <date> <time> MAREN001 GRA001 0001 MAREN001 SAMPLE.TAPESET.3 GRA002 0003 <date> <time> MAREN001 GRA002 0001 MAREN001 SAMPLE.TAPESET.3 % MARM120 TOTAL OF 14 MAREN CATALOG ENTRIES PROCESSED |
Bedeutung der Ausgabefelder:
| VOLUME | Archivnummer |
| FSEQ | Dateifolgenummer, temporär gesperrte Bänder werden mit FSEQ='*001' ausgegeben |
| CR-DATE | Erstellungsdatum |
| CR-TIME | Erstellungsuhrzeit |
| CR-JOB | Erstellungsjobname |
| 1STVSN | Erste Archivnummer des MF/MV-Sets |
| VSEQ | Dateiabschnittsnummer |
| USER-ID | Benutzerkennung |
| FILE-NAME | Dateiname (ggf. gekürzt) |
Beispiel 4: Ausgabe aller MAREN-Katalogeinträge zu einer Banddatei
Aus dem MAREN-Katalog sollen alle Bänder ausgegeben werden, die mit der Datei SAMPLE.TAPESET.1 beschrieben wurden oder bei denen sich zumindest dieser Dateiname im MAREN-Katalogeintrag befindet:
//show-volume-attributes volume=*all,user-id=*all,file-name=sample.tapeset.1(version=*all,type-of-vol=*any)
|
Von der Banddatei SAMPLE.TAPESET.1 existieren 5 Versionen auf folgenden Bändern:
Version 0 (*LATEST) auf GRA009
Version -1 auf GRA006, GRA007 und GRA008 (Multivolume-Datei)
Version -2 auf GRA003, GRA010, GRA004 und GRA005 (Multivolume-Datei); GRA003 ist obsolet, da es durch das später erstellte Band GRA010 (vgl. Bandfolgenummer: VSEQ=1 bei beiden Bänder) ersetzt wurde.
Version -3 auf GRA002
Version -4 auf GRA001
Beispiel 5: Ausgabe aller MAREN-Katalogeinträge zu einer Dateiversion
Von den im Beispiel 4 aufgelisteten Bändern sollen nur die ausgewählt werden, welche beim Erstellen der Dateiversion -1 verwendet wurden:
//show-volume-attributes volume=*all,user-id=*all,file-name=sample.tape.set.1(version=-1,type-of-vol=*any)
|
Beispiel 6: Ausgabe aller MAREN-Katalogeinträge zu veralteten Bändern
Von den im Beispiel 4 aufgelisteten Bändern sollen nur die ausgewählt werden, welche durch einen neuen Bänder ersetzt wurden. Anschließend sollen diese Bänder freigegeben werden:
//show-volume-attributes volume=*all,user-id=*all,file-name=sample.tape.set.1(version=-1,type-of-vol=*obs)
|
Beispiel 7:
Ausgabe aller MAREN-Katalogeinträge eines Directories mit einer bestimmten SAVE-FILE-ID
//show-volume-attributes directory-name=maren.v90b.dir(save-file-id=-0)
|
Die Informationen zu allen Bändern, die in der letzten, d.h. jüngsten Sicherungsdatei verzeichnet sind, werden ausgegeben.
Beispiel 8: Ausgabe aller Bänder, die einer Volume-Gruppe angehören.
//show-volume-attributes vol=*int(sh,sh9),vol-group=EPSWOS3*
|
Der Name der Volume-Gruppe wird ausgegeben, da die Volume-Gruppe über Musterzeichen ausgewählt wurde. Das Band ANCA01 gehört der Volume-Gruppe EPSWOS3-GER und das Band CLM020 der Volume-Gruppe EPSWOS3-CLM an.
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].
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 |
Kommentarfeld für interne Informationen | var(*LIST).ADM-FIELD | S | <c-string 1..8> | 1 |
Kommentarfeld für interne Informationen | var(*LIST).ADM-FIELD-2 | S | <c-string 1..16> | 1 |
Audit-Indicator | var(*LIST).AUDIT | S | *YES | 1 |
Prüfziffer | var(*LIST).CHECK-COUNT | S | <integer 00..99> | 1 |
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äte-Bezeichnung | var(*LIST).DEV-NAME | S | <c-string 1..4> | 1 |
Gerätetyp | var(*LIST).DEV-TYPE | S | <structured-name 1..8> | 1,2 |
Name eines Directories (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 |
Verwaltungsbereich | var(*LIST).DOMAIN | S | <c-string 1..8> | 1 |
Datei-Freigabedatum | var(*LIST).EXPIR-DATE | S | yyyy-mm-dd | 1 |
Versandanschrift. | 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).LAST-ACCESS- | S | <alphanum-name 1..8> | 1,2 |
Auftragsname des letzten Zugriffs | var(*LIST).LAST-ACCESS-JOB- | S | <name 1..8> | 1 |
Nummer der letzten MAREN-Funktion, die auf das Band zugegriffen hat. | var(*LIST).LAST-ACC-FUNC-FLAG | S | <integer 1..99> | 1 |
Name der letzten MAREN-Funktion, die auf das Band zugegriffen hat. | var(*LIST).LAST-ACC-FUNC-NAME | S | <alphanum-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 001..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 Zugriff | var(*LIST).PASS | S | *NONE | 1,2 |
Registrierungsdatum des Bandes | var(*LIST).REG-DATE | S | yyyy-mm-dd | 1 |
Bemerkungsfeld | var(*LIST).REMARK | S | <c-string 1..24> | 1,2 |
Frei versorgbares Benutzer-Feld | var(*LIST).REMARK-2 | S | <c-string 1..10> | 1 |
Frei versorgbares Benutzer-Feld | var(*LIST).REMARK-3 | S | <c-string 1..12> | 1 |
Reservierungszähler (4-stellig) | var(*LIST).RESERV-COUNT | S | <integer 0..9999> | 1,2 |
Archivierungsdatum | var(*LIST).RESERV-DATE | S | yyyy-mm-dd | 1,2 |
SAVE-FILE-ID (HSMS) oder SAVE-VERSION (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 Eigentümers | var(*LIST).USER-ACCOUNT | S | <alphanum-name 1..8> | 1,2 |
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> | 1,2 |
Benutzerkennung des Eigentü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 |