Diese Anweisung reserviert Bänder aus dem Freepool mit dem Namen *NO für die eigene Benutzerkennung. Das Band kann dabei mit bestimmten Schutzmerkmalen versehen werden. Katalogeintragsfelder können mit Werten versehen werden.
Format
| RESERVE-FREE-VOLUME | Kurzname: RSFV | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
NUMBER-OF-VOLUMES = 1 / <integer 1..32767>
Anzahl der Bänder. Gibt an, wie viele freie Bänder neu reserviert werden sollen.
SELECT =
Gibt die Kriterien an, nach denen freie Bänder ausgewählt werden sollen.
SELECT = *STD
Es werden die nachfolgend genannten Standardkriterien verwendet.
SELECT = *BY-ATTRIBUTES(...)
VOLUME =
Gibt einen Nummernkreis an, aus dem freie Bänder ausgewählt 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.
DEVICE-TYPE =
Gerätetyp.
DEVICE-TYPE = *STD
Es handelt sich um 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].
HOME-LOCATION = *STD / <alphanum-name 1..8>
Lagerortname oder symbolischer Lagerortname. Gibt an, aus welchem Archiv freie Bänder ausgewählt werden sollen.
HOME-LOCATION = *STD
Ausgewählt wird aus dem vom MAREN-Administrator festgelegten Standard-Lagerort.
PROTECTION =
Schutzmerkmale der Bänder.
PROTECTION = *STD
Es werden die nachfolgend genannten Standardkriterien verwendet.
PROTECTION = *PARAMETERS(...)
PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET
Kennwort. Das bisher gültige Kennwort muss hier angegeben werden, wenn das Band mit einem Kennwort geschützt ist.
PASSWORD = *NONE
Es wird kein Kennwort angegeben.
PASSWORD = *SECRET
Verlangt ein dunkelgesteuertes Eingabefeld für das Kennwort. Eingaben in dieses Feld sind am Bildschirm nicht sichtbar. Dieser Operandenwert kann nur im ungeführten Dialog angegeben werden. Im geführten Dialog steht für die Kennworteingabe generell ein dunkelgesteuertes Feld zur Verfügung.
USER-ACCESS =
Gibt an, ob fremde Benutzerkennungen auf das Band zugreifen dürfen.
USER-ACCESS = *OWNER-ONLY
Der Zugriff auf das Band ist nur unter der eigenen Benutzerkennung möglich.
USER-ACCESS = *FOREIGN-READ-ONLY
Unter fremder Benutzerkennung ist nur der Lesezugriff auf das Band möglich.
USER-ACCESS = *ALL-USERS
Unter fremder Benutzerkennung ist unbeschränkter Zugriff auf das Band möglich.
FREE-DATE =
Freigabedatum des Bandes. Bis zu diesem Datum bleibt das Band für die eingetragene Benutzerkennung reserviert.
FREE-DATE = *STD
Es gilt die vom MAREN-Administrator festgelegte Reservierungsdauer.
FREE-DATE = <date>
Datum im Format yyyy-mm-dd.
FREE-DATE = <integer 0..32767 days >
Zeitangabe in Tagen (Reservierungsdauer). Diese Zahl wird von MAREN zum aktuellen Tagesdatum addiert, um das Freigabedatum zu erzeugen.
FILE-NAME = *NONE / <filename 1..41 without-cat-user>
Name der Datei, die später auf das Band geschrieben werden soll.
VOLUME-GROUP = *NONE / <text 1..32 without-sep>
Legt fest, welcher Volume-Gruppe das neu reservierte Band zugewiesen wird. Bei *NONE wird es keiner Volume-Gruppe zugeordnet.
REMARK = *NONE / <c-string 1..24>
Bemerkungstext. Dieses Katalogeintragsfeld wird bei der MAREN-Anweisung SHOW-VOLUME-ATTRIBUTES ausgegeben.
REMARK-2 = *NONE / <c-string 1..10>
Bemerkungstext. Dieses Katalogeintragsfeld wird bei der MAREN-Anweisung SHOW-VOLUME-ATTRIBUTES ausgegeben.
REMARK-3 = *NONE / <c-string 1..12>
Bemerkungstext. Dieses Katalogeintragsfeld wird bei der MAREN-Anweisung SHOW-VOLUME-ATTRIBUTES ausgegeben.
USER-FIELD = *NONE / <c-string 1..54>
Bemerkungstext. Dieses Katalogeintragsfeld kann beliebige benutzerspezifische Daten enthalten, z.B. Name, Abteilung.
OUTPUT =
Bestimmt das Ausgabemedium für die Katalogeinträge. 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 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 Attribute.
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.
Hinweise
Die Anweisung RESERVE-FREE-VOLUME ist nicht zwingend notwendig, um ein freies Band für die eigene Benutzerkennung zu reservieren, da bei der Anforderung von SCRATCH-Bändern zum FILE- oder EOV-Zeitpunkt automatisch eine Reservierung aus dem Pool der freien Bänder erfolgt. Trotzdem kann diese Anweisung in folgenden Fällen sinnvoll angewendet werden:
Zu einem frühen Zeitpunkt kann gewährleistet werden, dass überhaupt freie Bänder vorhanden sind.
Falls in der Dateizuweisung keine RETENTION-PERIOD angegeben wird, kann bei dieser Funktion eine Reservierungsdauer eingetragen werden, die vom Standardwert abweicht.
Die benutzerspezifischen Katalogeintragsfelder, wie Kennwort oder Bemerkungen, können ausgefüllt werden.
Beispiel
//reserve-free-volume protection=*par(free-date=<date>),remark='my tape'
|
Diese Anweisung reserviert ein Band mit dem vom MAREN-Administrator eingestellten |
|
Diese Anweisung reserviert zwei Bänder vom Typ TAPE-C4. Diese werden im Katalogeintrag als uneingeschränkt mehrbenutzbar gekennzeichnet und mit einer Reservierungsdauer von 200 Tagen versehen.
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 der S-Variablen | T | Inhalt |
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 | 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 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 |
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 | *NO |
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). | 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 | var(*LIST).PASS | S | *NONE |
Bemerkungsfeld | var(*LIST).REMARK | S | <c-string 1..24> |
Reservierungs-Zähler (4-stellig) | 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 | var(*LIST).VOL-GROUP | S | <text 1..32> |
Bandabschnittsnummer | var(*LIST).VOL-SEQ | S | <integer 1..255> |
Bandstatus | var(*LIST).VOL-STA-1 | S | F/P/R/D |