Der Standardwert *UNCHANGED in den entsprechenden Operanden bedeutet jeweils, dass die bisherige Einstellung gilt. Mit dem Wert *NONE können im Katalogeintrag die angegebenen Katalogeintragsfelder gelöscht werden.
Format
| MODIFY-VOLUME-ATTRIBUTES | Kurzname: MD / MDVA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
,PROTECTION = *UNCHANGED / *PARAMETERS(...)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
VOLUME =
Archivnummern von Bändern, deren Katalogeinträge modifiziert werden sollen.
VOLUME = <vsn>(...)
Archivnummer.
FILE-SEQUENCE = 1 / <integer 1..9999>
Gibt die Dateifolgenummer an, deren Katalogeintrag modifiziert werden soll.
FILE-NAME = *UNCHANGED / *NONE / <filename 1..41 without-cat-user>
Name der Datei, die sich mit der angegebenen Dateifolgenummer auf dem Band befindet. Ist im Katalogeintrag ein Directory-Name eingetragen, so ist die Angabe DIR-NAME=*NONE notwendig, um einen Dateinamen eintragen zu können.
EXPIRATION-DATE = *UNCHANGED / *NONE / <date> / <integer 0..32767 days >
Datei-Freigabedatum. Die Reservierungsdauer kann vom MAREN-Administrator über die MARENADM-Anweisung MODIFY-VOLUME-ATTRIBUTES geändert werden. Der nichtprivilegierte Benutzer kann eine solche Änderung nur über die RETPD-Angabe in der ARCHIVE-Anweisung durchführen.
EXPIRATION-DATE = <date>
Datum im Format yyyy-mm-dd. Ein Datum, das kleiner ist als das aktuelle Tagesdatum, wird abgewiesen.
EXPIRATION-DATE = <integer 0..32767 days >
Zeitangabe in Tagen. Diese Zahl wird von MAREN zum aktuellen Tagesdatum addiert, um das Freigabedatum zu erzeugen.
VOLUME-SEQUENCE = *UNCHANGED / <integer 1..255>
Gibt die Dateiabschnittsnummer (Bandfolgenummer) innerhalb einer Multivolume-Datei (MV-Set) an.
FIRST-VOLUME = *UNCHANGED / *NONE / <vsn>
Bezeichnet die erste Archivnummer einer Multivolume-Datei (Dateimengenkennzeichen).
LAST-CLOSE-DATE = *UNCHANGED / *NONE / <date>
Datum im Format yyyy-mm-dd. Gibt an, an welchem Tag zuletzt eine Datei auf diesem Band geschlossen wurde.
LAST-CLOSE-TIME = *UNCHANGED / *NONE / <time>
Uhrzeit im Format: hh[:mm[:ss]], wobei bei hh, mm und ss führende Nullen weggelassen werden können. Gibt an, zu welcher Tageszeit zuletzt eine Datei auf diesem Band geschlossen wurde.
CREATION-CATALOG-ID = *UNCHANGED / *NONE / <cat-id>
Katalogkennung des Pubsets, auf dem das Band zuletzt beschrieben wurde. Ist im Katalogeintrag ein Directory-Name eingetragen, so ist die Angabe DIR-NAME=*NONE notwendig, um eine Katalogkennung eintragen zu können.
CREATION-USER-ID = *UNCHANGED / *NONE / <name 1..8>
Benutzerkennung, unter der das Band zuletzt beschrieben wurde. Ist im Katalogeintrag ein Directory-Name eingetragen, so ist die Angabe DIR-NAME=*NONE notwendig, um eine Benutzerkennung eintragen zu können.
CREATION-JOB-NAME = *UNCHANGED / *NONE / <name 1..8>
Jobname des Jobs, der das Band zuletzt beschrieben hat.
CREATION-DATE = *UNCHANGED / *NONE / <date>
Datum im Format yyyy-mm-dd. Gibt an, an welchem Tag das Band zuletzt beschrieben wurde.
CREATION-TIME = *UNCHANGED / *NONE / <time>
Uhrzeit im Format: hh[:mm[:ss]], wobei bei hh, mm und ss führende Nullen weggelassen werden können. Gibt an, zu welcher Tageszeit das Band zuletzt beschrieben wurde.
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 = *ALL
Bearbeitet werden alle Bänder.
VOLUME = *BY-INPUT-FILE(...)
Trifft eine Auswahl der zu modifizierenden Katalogeinträge über eine Eingabedatei.
FILE-NAME = <filename 1..54>
Name einer SAM-Datei, welche komplette Katalogeinträge im MAREN-Format enthält. Es können aber auch mithilfe eines Editors erstellte Dateien zugewiesen werden.
Aus allen Katalogeinträgen der Eingabedatei werden nur die darin enthaltenen Archivnummern (VOLUME) und Dateifolgenummern (FILE-SEQUENCE) ausgewertet. Zum betreffenden Band wird der jeweilige Katalogeintrag aus dem MAREN-Katalog gelesen und dort die in der Anweisung angegebenen Katalogeintragsfelder aktualisiert.
Befindet sich zu einem in der Eingabedatei enthaltenen Band kein Katalogeintrag im MAREN-Katalog, so wird dies protokolliert, Auftragsschalter 31 gesetzt und die Verarbeitung wird mit dem nächsten Katalogeintrag aus der Eingabedatei fortgesetzt.
Wird eine Datei zugewiesen, die keine kompletten Katalogeinträge enthält, sondern mithilfe eines Editors erstellt wurde, so müssen die darin hinterlegten Sätze folgenden Aufbau haben:
Byte | Inhalt |
1-4 | Satzlängenfeld |
5-10 | Archivnummer, evtl. rechtsseitig aufgefüllt mit Leerzeichen, z.B. 'TAPE1 |
11-14 | Dateifolgenummer, z.B. '0001' |
15-510 | nicht versorgt oder beliebiger Text |
Es werden ausschließlich die Katalogeinträge im MAREN-Katalog aktualisiert. Die Eingabedatei wird nicht verändert.
SELECT =
Gibt an, welche Katalogeinträge zur Bearbeitung ausgewählt werden sollen.
SELECT = *ALL
Alle durch den VOLUME-Operand ermittelten Katalogeinträge werden bearbeitet
SELECT = *BY-DIRECTORY (...)
Es sollen alle Bänder eines Sicherungslaufes zu einem Directory bearbeitet werden. Die Selektion kann bereits mit dem Operanden VOLUME eingeschränkt worden sein.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>
Name des Directory. Es werden nur reservierte Bänder ausgewählt, die dem POOL des 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.
SAVE-FILE-ID =
Die auszulagernden Bänder werden über die Sicherungsdatei des oben angegebenen Directory ausgewählt.
SAVE-FILE-ID = *ALL
Alle Bänder der angegebenen Sicherungsdatei werden ausgewählt.
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.
SELECT = *BY-VOLUME-GROUP (...)
Die Auswahl der Bänder, die bearbeitet werden sollen, erfolgt zusätzlich über die Angabe der Volume-Gruppe.
VOLUME-GROUP = *ANY / *NONE / <text 1..32 without-sep>
Legt fest, welcher Volume-Gruppe ein Band angehören muss, damit es bearbeitet wird. Bei der Angabe *ANY ist die Volume-Gruppe ohne Bedeutung, bei *NONE darf das Band keiner Volume-Gruppe angehören. Als letztes Zeichen kann ein „*“ eingegeben werden. In diesem Fall werden alle Volume-Gruppen ausgewählt, die mit der angegebenen Zeichenfolge beginnen.
PASSWORD = *NONE / *YES / <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 = *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.
PROTECTION = *UNCHANGED / *PARAMETERS(...)
Schutzmerkmale des Bandes.
NEW-PASSWORD = *UNCHANGED / *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET
Kennwort zum Schutz vor unberechtigtem Zugriff auf das Band. Ein Kennwort C'$$$$' ist nicht zugelassen. Mit diesem Operand wird das Kennwort geändert.
NEW-PASSWORD = *UNCHANGED
Gibt an, dass das bisherige Kennwort nicht verändert werden soll.
NEW-PASSWORD = *NONE
Gibt an, dass das bisherige Kennwort gelöscht werden soll.
NEW-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 eingetragenen 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 = *UNCHANGED / <date> / <integer 0..32767 days >
Freigabedatum des Bandes. Bis zu diesem Datum bleibt das Band für die eingetragene Benutzerkennung reserviert.
FREE-DATE = <date>
Datum im Format yyyy-mm-dd. Ein Datum, das kleiner ist als das aktuelle Tagesdatum, wird abgewiesen.
FREE-DATE = <integer 0..32767 days >
Zeitangabe in Tagen (Reservierungsdauer). Diese Zahl wird von MAREN zum aktuellen Tagesdatum addiert, um das Freigabedatum zu erzeugen.
EXPIRATION-DATE =
Freigabedatum für alle Dateien des Bandes.
EXPIRATION-DATE = *UNCHANGED
Keine Aktualisierung des Freigabedatums.
EXPIRATION-DATE = *NONE
Freigabedatum wird für alle ausgewählten Dateien gelöscht.
EXPIRATION-DATE = <date>
Datum im Format yyyy-mm-dd. Ein Datum, welches kleiner als das aktuelle Tagesdatum ist, wird abgewiesen.
EXPIRATION-DATE = <integer 0..32767 days >
Zeitangabe in Tagen. Diese Zahl wird von MAREN zum aktuellen Tagesdatum addiert, um das Freigabedatum zu erzeugen.
INITIALIZATION = *UNCHANGED / *YES / *ERASE
Gibt an, ob das Band nach Erreichen des Freigabedatums neu initialisiert werden soll.
INITIALIZATION = *YES
Das Band soll nach einer Freigabe initialisiert werden. Falls es jedoch vor der Freigabe noch einmal beschrieben wird, so wird, falls die Banderstellung ohne Schutzkriterien erfolgte, der Wert für INITIALIZATION wieder auf NO gesetzt.
INITIALIZATION = *ERASE
Gibt an, ob das Band nach Erreichen des Freigabedatums gelöscht werden soll.
DIRECTORY-NAME = *UNCHANGED / *NONE / <filename 1..54 without-gen-vers>
Name eines Directory, dem das Band zugeordnet ist. 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. Sind die Katalogeintragsfelder FILE-NAME, CRE-CATALOG-ID und CRE-USER-ID mit Werten versorgt, so sind diese mit *NONE zu löschen (z.B. FILE-NAME=*NONE).
DIRECTORY-NAME = *NONE
Ein eventuell vorhandener Directory-Name wird gelöscht.
VOLUME-GROUP = *UNCHANGED / *NONE / <text 1..32 without-sep>
Legt fest, welcher (neuen) Volume-Gruppe ein ausgewähltes Band zugewiesen wird. Bei *UNCHANGED bleibt die Zuordnung bestehen, bei *NONE wird gegebenenfalls die Zugehörigkeit zu einer Volume-Gruppe gelöscht.
HOME-LOCATION = *UNCHANGED / <alphanum-name 1..8>
Lagerortname oder symbolischer Lagerortname. Gibt an, an welchem Lagerort das Band standardmäßig aufbewahrt bzw. gelagert werden soll.
REMARK = *UNCHANGED / *NONE / <c-string 1..24>
Bemerkungstext. Dieses Katalogeintragsfeld wird bei der MAREN-Anweisung SHOW-VOLUME-ATTRIBUTES ausgegeben.
REMARK-2 = *UNCHANGED / *NONE / <c-string 1..10>
Bemerkungstext. Dieses Katalogeintragsfeld wird bei der MAREN-Anweisung SHOW-VOLUME-ATTRIBUTES ausgegeben.
REMARK-3 = *UNCHANGED / *NONE / <c-string 1..12>
Bemerkungstext. Dieses Katalogeintragsfeld wird bei der MAREN-Anweisung SHOW-VOLUME-ATTRIBUTES ausgegeben.
USER-FIELD = *UNCHANGED / *NONE / <c-string 1..54>
Bemerkungstext. Dieses Katalogeintragsfeld kann beliebige benutzerspezifische Daten enthalten, z.B. Name, Abteilung.
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 VOLUME=*INTERVAL/*ALL angegeben und können im angegebenen Bereich einige Katalogeinträge nicht modifiziert werden, dann werden diese Katalogeinträge mit einer entsprechenden Meldung protokolliert und die Anweisung wird fortgesetzt.
Für alle Folgebänder eines MF/MV-Sets kann kein Freigabedatum vergeben werden, das kleiner ist als das Freigabedatum des ersten Bandes. Sollen alle Bänder eines MF/MV-Sets freigegeben werden, dann ist daher immer zuerst das Freigabedatum des ersten Bandes (VOLUME-SEQUENCE = 1) zurückzusetzen.
Beim Heraufsetzen des Datei-Freigabedatums EXPIRATION-DATE wird ggf. auch das Freigabedatum FREE-DATE heraufgesetzt.
Beim Herabsetzen des Datei-Freigabedatums EXPIRATION-DATE wird das Katalogeintragsfeld INITIALIZATION auf YES gesetzt.
Für Bänder, die einem Lagerort mit dem Bedienmodus ROBAR-2 zugewiesen sind, ist die Änderung des Lagerorts nicht möglich.
Der Benutzer kann bei eigenen Bändern, die vom MAREN-Administrator einem Directory-Freibandpool zugewiesen wurden (FREE-POOL=<filename>), den Directory-Namen nicht ändern.
Eine Änderung oder Löschung des Directory-Namens ist dann angebracht, wenn das Directory, dem das Band zugeordnet war, umbenannt bzw. gelöscht wurde.
Bänder in Directories werden trotz erreichtem Freigabedatum nicht freigegeben. Sie werden erst freigegeben, nachdem sie mit den entsprechenden ARCHIVE- oder HSMS-Anweisungen aus dem Directory entfernt wurden (ARCHIVE: PURGE oder POOL; HSMS: MODIFY-ARCHIVE SAVE=*DELETE oder VOLUME= *REMOVE). Ist dies nicht möglich, weil das Directory mittlerweile gelöscht worden ist, kann nachträglich mit der Anweisung MODIFY-VOLUME-ATTRIBUTES DIRECTORY-NAME=*NONE die MAREN-interne Zuordnung zu einem Directory aufgehoben werden.
Werden die Bänder über eine Sicherungsdatei aus HSMS selektiert (Operand SELECT=*BY-DIRECTORY(...)), dann werden auch temporär gesperrte Katalogeinträge bearbeitet.
Zusammengehörende Bänder können zu einer Volume-Gruppe zusammengefasst werden. Alle Dateien, die sich auf einem Band befinden, gehören automatisch dieser Volume-Gruppe an. Wird ein reserviertes Band, das einer Volume-Gruppe zugeordnet ist, freigegeben, so wird die Volume-Gruppen-Zuordnung für dieses Band wieder aufgehoben.
Beispiele
//modify-volume-attributes volume=idx005,free-date=<date>,user-acc=*all
|
Das Freigabedatum für das Band IDX005 wird auf das angegebene Datum festgelegt. |
//modify-volume-attributes volume=tape01,pass='x2w3',new-pass=*none
|
Mit dieser Anweisung wird ein bestehendes Kennwort für das Band TAPE01 gelöscht. |
|
Mit dieser Anweisung wird im Bemerkungsfeld der archivierten Bänder IDX006 bis IDX008 des betreffenden Benutzers der Text project1 eingetragen.
|
Alle Bänder, in deren Katalogeintragsfeld REMARK sich der Text „SAVEPROG“ befindet, sollen freigegeben werden. Dazu ist bei der Anweisung PRINT-VOLUME-ATTRIBUTES im SELECT-Parameter anzugeben, dass die Zeichenfolge im Katalogeintragsfeld REMARK mit „SAVEPROG“ übereinstimmen soll. Für diese Auswahl existiert bereits der Parametersatz SAVE01. Die Ausgabe soll in die Datei LIST.VOL.2 erfolgen.
Die bei PRINT-VOLUME-ATTRIBUTES zugewiesene Ausgabedatei dient danach als Eingabedatei für die Anweisung MODIFY-VOLUME-ATTRIBUTES:
|