Berechtigung ADA, DA, Administrator ohne Domänen
Diese Anweisung gibt Informationen über freie Bänder nach SYSOUT aus. Die Katalogeinträge der freien Bänder können auch in eine Ausgabedatei geschrieben werden. Für eine Tabellenverarbeitung kann die Datei auch im CSV-Format erstellt werden. Eine Ausgabedatei kann per E-Mail verschickt wird.
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-FREE-VOLUMES | Kurzname: SHFV | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
VOLUME =
Archivnummern von Bändern, über die Informationen gewünscht werden.
VOLUME = *ALL
Bearbeitet werden alle Bänder.
VOLUME = *INTERVAL(...)
Bearbeitet werden alle Bänder, deren Archivnummer im nachfolgend 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 Programmschnittstelle eingegeben wird.
FREE-LOCATION = *ALL / <alphanum-name 1..8>
Lagerortname oder symbolischer Lagerortname. Bearbeitet werden alle Katalogeinträge mit dem angegebenen Lagerort für freie Bänder.
FREE-LOCATION = *ALL
Bearbeitet werden alle Lagerorte für freie Bänder.
DEVICE-TYPE =
Gerätetyp.
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 = *ALL-TAPES
Ausgegeben werden alle Bänder (siehe Hinweise auf "SHOW-FREE-VOLUMES Informationen über freie Bänder ausgeben").
DEVICE-TYPE = <structured-name 1..8>
Gerätetyp. Zu den möglichen Angaben (abhängig von der BS2000-Version) siehe Handbuch „Systeminstallation“ [6].
USAGE =
Gibt an, ob bei der Ausgabe der Katalogeinträge eine Auswahl nach der Reservierungsart der freien Bänder getroffen werden soll. Die Reservierung kann entweder explizit über die Anweisung RESERVE-FREE-VOLUME oder implizit über die automatische Freibandzuweisung MARENUCP erfolgen.
USAGE = *ANY
Es sollen die Katalogeinträge aller freien Bänder ungeachtet ihrer Reservierungsart ausgegeben werden.
USAGE = *BY-MARENUCP
Es sollen die Katalogeinträge von freien Bändern ausgegeben werden, die nur über die automatische Freibandzuweisung, also über MARENUCP reserviert werden können.
FREE-POOL =
Nimmt eine Auswahl der auszugebenden Katalogeinträge 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 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.
DOMAIN =
Gibt die Domäne an, deren freie Bänder angezeigt werden.
DOMAIN = *ANY
Freie Bänder aller Domänen werden angezeigt.
DOMAIN = *OWN
Freie Bänder der eigenen Domäne werden angezeigt.
Die eigene Domäne ist die Domäne des Systems, an dem der ADA aktuell arbeitet.
DOMAIN = *STD-DOMAIN
Freie Bänder der Standard-Domäne werden angezeigt.
DOMAIN = <alphanum-name 1..8>
Gibt die Domäne an, deren freie Bänder angezeigt werden.
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.
SORT-MODE =
Gibt an, nach welchem Katalogeintragsfeld die Ausgabe sortiert werden soll.
SORT-MODE = *VOLUME
Die Katalogeinträge werden nach Archivnummern sortiert.
SORT-MODE = *RESERVATION-COUNT
Die Katalogeinträge werden nach dem Reservierungszähler sortiert.
SORT-MODE = *LAST-ACCESS-DATE
Die Katalogeinträge werden nach dem Datum des letzten Zugriffs sortiert.
SORT-MODE = *FREE-DATE
Die Katalogeinträge werden nach dem Datum der letzten Freigabe sortiert.
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).
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 wie z.B. MARENADM STATEMENT SHOW-FREE-VOLUMES, 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.
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.
Hinweise
Wird ein Sortierkriterium ungleich *VOLUME gewählt (z.B. SORT-MODE = *FREE-DATE), so wird ein evtl. für den Operanden DEVICE-TYPE angegebener Wert *ALL-TAPES für die weitere Verarbeitung durch den Wert *STD ersetzt. Es werden somit nicht alle Bänder ausgegeben, sondern sinnvollerweise nur Bänder vom Standard-Gerätetyp.
Je nach der Anzahl der im angegebenen Nummernkreis vorhandenen Bänder kann die Ausgabe der Katalogeinträge viel Zeit beanspruchen. Dies ist insbesondere dann der Fall, wenn ein anderes Sortierkriterium als *VOLUME gewählt wurde. Es empfiehlt sich daher, die Ausgabe in einem Batchprozess vorzunehmen oder sich des Direktzugriffs auf den MAREN-Katalog zu bedienen (Programmablauf unter der Katalogkennung bzw. unter der Benutzerkennung TSOS).
Spin-off wird ausgelöst, wenn der angegebene Lagerort für freie Bänder falsch ist oder kein freies Band im angegebenen Bereich gefunden wurde.
Beispiele
//show-free-volumes
Die Katalogeinträge aller freien Bänder vom festgelegten Standard-Gerätetyp werden ausgegeben. Nach der Ausgabe von jeweils 18 Einträgen wird der Benutzer gefragt, ob die Auflistung abgebrochen oder fortgesetzt werden soll.
//show-free-volumes volume=*interval(from=id0,to=id9),output=list.freevol.2
|
Aufgelistet werden alle freien Bänder des Standard-Gerätetyps im Archivnummernbereich |
----------------------------------------------------------------------------- VOLUME DEV-T FREE-LOC U RESC L-A-HOST L-A-DATE FREE-DATE L-A-USER ADM-FIELD----------------------------------------------------------------------------- TST005 T-C4 ROBABBA1 0055 D241ZE15 <date> <date> TSOS TST013 T-C4 ROBABBA1 0056 D241ZE15 <date> <date> TSOS TST017 T-C4 ROBABBA1 0054 D241ZE15 <date> <date> USER1 TST019 T-C4 ROBABBA1 0222 D241ZE14 <date> <date> TSOS 352235 TST021 T-C4 ROBABBA1 0047 D241ZE15 <date> <date> TEST08 TST024 T-C4 ROBABBA1 0187 D241ZE14 <date> <date> SYSMAREN TST026 T-C4 ROBABBA1 0061 D241ZE15 <date> <date> TSOS % MARM120 TOTAL OF 8 MAREN CATALOG ENTRIES PROCESSED |
Die Katalogeinträge aller freien Bänder (Standard-Gerätetyp), die einem Freibandpool für HSMS/ARCHIVE-Anwendungen unter beliebiger Benutzerkennung zugeordnet sind, werden ausgegeben.
Bedeutung der Katalogeintragsfelder:
| VOLUME | Archivnummer |
| DEV-T | Gerätetyp |
| FREE-LOC | Lagerort für freie Bänder |
| U | Reservierungs-Kennzeichen USAGE Kennzeichnung U: Reservierung nur durch MARENUCP möglich. |
| RESC | Reservierungs-Zähler |
| L-A-HOST | Name des Systems mit dem letzten Zugriff |
| L-A-DATE | Datum des letzten Zugriffs |
| FREE-DATE | Freigabedatum |
| L-A-USER | Benutzerkennung des letzten Zugriffs |
| ADM-FIELD | Bemerkungsfeld |
|
Aufgelistet werden alle freien Bänder des Standard-Gerätetyps im Archivnummernbereich von ID0 bis ID1.
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) | var(*LIST).ACCESS-COUNT | S | <integer 0..99999999> |
Erstellungsdatum | var(*LIST).CRE-DATE | S | yyyy-mm-dd |
Erstellungs-Jobname | var(*LIST).CRE-JOB-NAME | S | ’’ |
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 |
Zustand (exportiert oder nicht) | var(*LIST).EXPORTED | S | *NO |
Erste Archivnummer des MF/MV-Sets | var(*LIST).FIRST-VOL | S | <vsn> |
Dateiname einer Banddatei | var(*LIST).F-NAME | S | <filename 1..41> |
Freigabedatum des Bandes | var(*LIST).FREE-DATE | S | yyyy-mm-dd |
Freigabe-Lagerort | 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> |
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 |
Bemerkungsfeld, welches mit einem aussagekräftigen Text ausgefüllt werden soll. | var(*LIST).REMARK | S | <c-string 1..24> |
Reservierungs-Zähler | var(*LIST).RESERV-COUNT | S | <integer 0..9999> |
Archivierungsdatum | 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 |
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 | var(*LIST).VOL-STA-1 | S | F/P/R/D |