Ein Tape-Set besteht aus allen Bändern, die zu einer Banddatei gehören (genauer: es besteht aus allen Katalogeinträgen, bei denen FILE-NAME und FIRST-VOL übereinstimmen).
Der Standardwert *UNCHANGED in den entsprechenden Operanden bedeutet jeweils, dass die bisherige Einstellung weiter gilt.
Mit dem Wert *NONE können im Katalogeintrag die angegebenen Katalogeintragsfelder gelöscht werden.
Format
MODIFY-TAPE-SET-ATTRIBUTES | Kurzname: MDTSA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
SELECT = *BY-ATTRIBUTES(...)
Gibt an, welches Tape-Set zum Ändern ausgewählt werden soll.
FILE-NAME = <filename 1..41 without-cat-user>
Gibt an, zu welchem Dateinamen ein Tape-Set ausgewählt werden soll.
VERSION =
Mit diesem Operand kann für die angegebene Datei eine bestimmte Version (bzw. Dateistand) ausgewählt werden.
VERSION = *LATEST
Es wird die neueste (zuletzt erzeugte) Dateiversion ausgewählt.
VERSION = <integer -9999..0>
Angabe 0 entspricht *LATEST, Angabe -1 bedeutet vorletzter Dateistand, usw.
VERSION = *ALL
Zu dem angegebenen Dateinamen werden alle vorhandenen Bänder ausgewählt.
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 daher 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 Angabe von VERSION=*NOT-CREATED wird der Operand TYPE-OF-VOLUMES nicht ausgewertet.
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.
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.
TYPE-OF-VOLUMES = *ANY
Die Bandfolgenummern für ein Tape-Set werden nicht auf mehrfaches Vorkommen untersucht.
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.
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 Operanden wird das Kennwort geändert.
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 =*UNCHANGED / *OWNER-ONLY / *FOREIGN-READ-ONLY / *ALL-USERS
Gibt an, ob fremde Benutzerkennungen auf das Band zugreifen dürfen.
USER-ACCESS = *OWNER-ONLY
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, welches 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 = *UNCHANGED / *NONE / <date> / <integer 0..32767 days >
Datei-Freigabedatum.
EXPIRATION-DATE = <date>
Datum im Format yyyy-mm-dd. Ein Datum, welches 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.
INITIALIZATION = *UNCHANGED / *YES / *ERASE
Gibt an, ob das Band nach Erreichen des Freigabedatums neu initialisiert und ggf. zusätzlich gelöscht werden soll.
INITIALIZATION = *YES
Das Band soll nach einer Freigabe initialisiert werden. Falls dieser 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
Das Band soll nach einer Freigabe initialisiert werden. Dabei soll auch der Bandinhalt gelöscht werden.
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.
Hinweise
Wenn bei der Bestimmung des MAREN-Tape-Sets Fehler auftreten, z.B. weil zu einer Dateiversion nur die Bänder mit den Bandfolgenummern (VOLUME-SEQUENCE) 1 und 3 im MAREN-Katalog eingetragen sind, die Bandfolgenummer 2 jedoch dort fehlt, dann werden die Katalogeinträge nicht geändert.
Für Bänder eines Tape-Sets, die einem Lagerort mit dem Bedienmodus ROBAR-2 zugewiesen sind, ist die Änderung des Lagerorts nicht möglich.
Welche Katalogeintragsfelder bei der Ermittlung einer Dateiversion und damit eines Tape-Sets eine Rolle spielen, ist im „MAREN Systemverwalterhandbuch“ [1] beschrieben.
Sollen Bandattribute verändert werden, erfolgt die Änderung zusätzlich im FSEQ-1-Eintrag, falls zu dem Tape-Set auch Einträge mit FSEQ > 1 gehören.
Dies betrifft folgende Operanden:INITIALIZATION
EXPIRATION-DATE
Dies führt evtl. zur Änderung von FREE-DATE im FSEQ-1-Eintrag. Beim Herabsetzen des EXPIRATION-DATE würde auch das Initialisierungskennzeichen gesetzt werden.FREE-DATE
Wird nur dann herabgesetzt, wenn alle Katalogeinträge zu diesem Band ein EXPIRATION-DATE aufweisen, das kleiner oder gleich dem neuen FREE-DATE ist.
Werden die Operanden HOME-LOC, FREE-LOC, TEMP-LOC, EXPORT-ADDRESS und EXPORT-DATE in einem Eintrag mit FSEQ > 1 geändert, gibt MAREN die Meldung
MARM020aus.Kann der FSEQ-1-Eintrag nicht gelesen oder geändert werden, weil dieser Eintrag z.B. noch in Verarbeitung ist, gibt MAREN die Meldung
MARM021aus.
Beispiel
|
Auf alle Bänder der eigenen Benutzerkennung, die mit der Banddatei TAPE.FILE beschrieben wurden, soll von fremden Benutzerkennungen aus der Lesezugriff erlaubt sein. Ausgewählt werden alle Versionen und somit alle Tape-Sets dieser Datei im MAREN-Katalog (VERSION=*ALL). Gibt es zu einzelnen Versionen dieser Datei Bänder, die zwar beschrieben, jedoch in einem späteren Restart durch andere Bänder ersetzt wurden, so werden diese nicht modifiziert (TYPE-OF-VOLUMES=*VALID).