Berechtigung ADA, DA, Administrator ohne Domänen
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.
Der DA kann die Anweisung nur in der eigenen Domäne ausführen. Der Operand DOMAIN ist daher für ihn ohne Bedeutung.
Format
| RESERVE-FREE-VOLUME | Kurzname: RSFV | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
USER-IDENTIFICATION = <name 1..8>
Gibt die Benutzerkennung an, der das Band zugeordnet werden soll.
ACCOUNT = *NONE / <alphanum-name 1..8>
Abrechnungsnummer der angegebenen Benutzerkennung.
NUMBER-OF-VOLUMES = 1 / <integer 1..32767>
Anzahl der Bänder. Gibt an, wie viele freie Bänder neu reserviert werden sollen.
SELECT = *STD / *BY-ATTRIBUTES
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 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.
DEVICE-TYPE =
Gerätetyp.
DEVICE-TYPE = *STD
Es handelt sich um 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].
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-Dauerlagerort.
PROTECTION =
Schutzmerkmale des Bandes
PROTECTION = *STD
Es werden die nachfolgend beschriebenen Standardwerte verwendet.
PROTECTION = *PARAMETERS(...)
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 eingetragenen Benutzerkennung möglich.
USER-ACCESS = *FOREIGN-READ-ONLY
Unter fremder Benutzerkennung ist nur 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. Diese Zahl wird von MAREN intern 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.
DOMAIN =
Legt die Domäne fest, für die freie Bänder reserviert werden.
DOMAIN = *STD-DOMAIN
Freie Bänder werden für die Standard-Domäne reserviert.
DOMAIN = *OWN
Freie Bänder werden für die eigene Domäne reserviert.
Die eigene Domäne ist die Domäne des Systems, an dem der ADA aktuell arbeitet.
DOMAIN = <alphanum-name 1..8>
Freie Bänder werden für die angegebene Domäne reserviert.
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.
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.
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 wird abgebrochen und Spin-off ausgelöst, wenn ein angegebener Gerätetyp nicht zugelassen oder das Freigabedatum kleiner als das Tagesdatum ist. Spin-off wird auch ausgelöst, wenn NUMBER-OF-VOLUMES nicht erfüllt werden konnte.
Bänder, die noch nicht aufgeräumt wurden (HOME-LOCATION ungleich TEMP-LOCATION), können mit RESERVE-FREE-VOLUME nur an dem System, an dem sie sich gerade befinden, reserviert werden.
Die Katalogeintragsfelder ADMINISTRATOR-FIELD, ADMINISTR-FIELD-2, AUDIT, INITIALIZATION und ACCESS-COUNT (Zugriffszähler) bleiben unverändert. Der Wert von RESERVATION-COUNT (Reservierungszähler) wird um eins erhöht.
Beim Operanden DEVICE-TYPE wird nicht unterschieden zwischen TAPE-C5 und TAPE-C6. Deshalb kann z.B. auf eine Anforderung mit Typ TAPE-C5 auch ein Band mit Typ TAPE-C6 reserviert werden.
Beispiel
|
Ein Band vom Typ TAPE-C4 wird für die Benutzerkennung USER2 unter der Abrechnungsnummer ACC1 reserviert. Die Reservierungsdauer entspricht dem Operand DEFAULT-FREE-DATE. Das Band ist nicht mehrfach benutzbar und enthält keine Eintragung im Bemerkungsfeld des Katalogeintrags.
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 | *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).LAST-ACCESS- | 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 den Zugriff | 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 | <integer0..15> |
Nummer des Folgebands innerhalb eines parallelen Sicherungslaufs in HSMS | var(*LIST).SUBSEQ | S | <integer0..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 (4-stellig) | var(*LIST).VOL-SEQ | S | <integer 1..255> |
Bandstatus | var(*LIST).VOL-STA-1 | S | F/P/R/D |