Die Anweisung EXPORT-VOLUME hat folgende Funktionen:
Sie kennzeichnet eigene Bänder im MAREN-Katalog als ausgeliehen;
Sie kennzeichnet fremde Bänder im MAREN-Katalog als zum Eigentümer zurückgesandt.
Bei fremden Bändern wird der Katalogeintrag aus dem MAREN-Katalog entfernt.
Format
| EXPORT-VOLUME | Kurzname: EXV | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
VOLUME =
Gibt die Archivnummern der Bänder an, die exportiert werden sollen.
VOLUME = *BY-FILE(...)
Es sollen alle Bänder einer Datei bzw. eines Tape-Sets exportiert werden.
FILE-NAME = <filename 1..41 without-cat-user>
Gibt an, zu welchem Dateinamen ein Tape-Set ausgeliehen 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. Die Angabe -1 bedeutet vorletzter Dateistand, usw.
VERSION = *ALL
Zu dem angegebenen Dateinamen werden alle vorhandenen Bänder ausgewählt.
USER-IDENTIFICATION =
Dieser Operand bezieht sich auf die Benutzerkennung, der die Bänder zugeordnet sind (Katalogeintragsfeld USER-ID).
USER-IDENTIFICATION = *OWN
Ausgewählt werden nur Bänder, die im Katalogeintrag den angegebenen Dateinamen besitzen und der eigenen Benutzerkennung zugeordnet sind.
USER-IDENTIFICATION = *ALL
Bei der Auswahl werden die Benutzerkennungen nicht ausgewertet.
USER-IDENTIFICATION = <name 1..8>
Ausgewählt werden nur solche Bänder, die der angegebenen Benutzerkennung zugeordnet sind.
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.
TYPE-OF-VOLUMES = *VALID(...)
Bei mehrfach vorkommenden Bandfolgenummern werden für ein Tape-Set immer nur die zuletzt erstellten ausgewählt.
CLOSE-CHECK =
Dieser Operand bestimmt, ob das Katalogeintragsfeld CLOSE-INDICATOR ausgewertet werden soll.
CLOSE-CHECK = *YES
Wenn bei einem Band des ausgewählten Tape-Sets das Katalogeintragsfeld CLOSE-INDICATOR nicht auf CLOSED steht, dann wird die Anweisung abgebrochen.
CLOSE-CHECK = *NO
Das Katalogeintragsfeld CLOSE-INDICATOR wird nicht ausgewertet.
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.
VOLUME = *BY-DIRECTORY(...)
Ausgeliehen werden alle Bänder, die im angegebenen Directory (als gesicherte Dateien) aufgelistet sind.
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 zu exportierenden Bänder werden über die Sicherungsdatei dem oben angegebenen Directory 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.
VOLUME = *INTERVAL (...)
Bearbeitet werden alle Bänder, deren Archivnummer im angegebenen Bereich liegt.
FROM = <vsn>
Archivnummer. Bearbeitet werden alle Bänder, deren Archivnummer größer oder gleich der angegebenen Archivnummer ist.
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 = list-poss(10): <vsn>
Archivnummern der Bänder, die exportiert werden sollen.
VOLUME = *BY-VOLUME-GROUP(...)
Ausgeliehen werden alle Bänder der angegebenen Volume-Gruppe.
VOLUME-GROUP = <text 1..32 without-sep>
Legt die Volume-Gruppe fest, der ein Band angehören muss, damit es ausgeliehen wird. Als letztes Zeichen kann ein „*“ eingegeben werden. In diesem Fall werden alle Volume-Gruppen ausgewählt, die mit der angegebenen Zeichenfolge beginnen.
EXPORT-ADDRESS = <c-string 1..50> / *BY-CATALOG
Versandanschrift. Gibt an, wohin das Band verschickt werden soll. Bei Selbstabholung kann irgendein sinnvoller Text angegeben werden, z.B. „Mailbox G7“.
EXPORT-ADDRESS = *BY-CATALOG
Es soll die im Katalogeintrag des Bandes bereits vermerkte Versandanschrift für das Exportieren verwendet werden.
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.
LAYOUT =
Gibt an, wie der Ausgabebeleg erstellt werden soll, sofern der MAREN-Administrator den Parameter EXPORT-RECEIPT nicht auf *NO gesetzt hat.
LAYOUT = *STD
Der Ausgabebeleg wird mit dem Standard-Layout erzeugt.
LAYOUT = <filename 1..54 without-gen-vers>
Layout-Datei. Der Ausgabebeleg wird so erstellt, wie er in der Layout-Datei vom MAREN-Administrator definiert wurde.
Hinweise
Der MAREN-Administrator kann festlegen, dass bei jedem Export ein Ausgabebeleg (sog. „EXPORT RECEIPT“) erstellt wird. Dieser Beleg wird zunächst in eine Datei geschrieben und anschließend (wahlweise) ausgedruckt. Der Dateiname lautet
$<userid>.MAREN.EXPORT-RECEIPT.<vsn>, wobei <userid>die Benutzerkennung der aufrufenden Task ist. Existiert die Datei bereits, wird sie fortgeschrieben, anderenfalls neu erstellt. Falls in MAREN das sofortige Ausdrucken eingestellt ist, wird die Datei nach dem Ausdrucken automatisch gelöscht. Wenn eine Liste von mehreren Archivnummern angegeben wurde, wird die Datei erst nach der Verarbeitung der letzten Archivnummer ausgedruckt. Wenn bei einer Liste ein Band nicht exportiert werden kann, dann wird die EXPORT-Anweisung abgebrochen.Wenn der MAREN-Administrator eingestellt hat, dass Ausgabebelege zwar erstellt, aber nicht sofort automatisch ausgedruckt werden, dann hängt es von der jeweiligen Organisation im Data Center ab, was der Benutzer mit der Datei
MAREN.EXPORT-RECEIPT.<vsn>unter seiner Benutzerkennung machen muss.Beim Exportieren eines eigenen Bandes wird intern das Katalogeintragsfeld EXPORT-DATE mit dem Tagesdatum versorgt und das Katalogeintragsfeld TEMPORARY-LOCATION wird auf CENTRAL gesetzt.
Beim Exportieren eines fremden Bandes wird der Katalogeintrag aus dem MAREN-Katalog gelöscht. Alle eventuell vorhandenen Multifile-Katalogeinträge mit FSEQ > 1 werden ebenfalls gelöscht.
Wenn im MAREN-Katalog ein temporär gesperrtes Band mit derselben Archivnummer existiert wie das, das zurückgeholt werden soll, so kann das Exportieren nur vom MAREN-Administrator vorgenommen werden.
In folgenden Fällen wird die Anweisung mit einer Fehlermeldung abgebrochen und Spin-off ausgelöst:
Band nicht im MAREN-Katalog;
Band gerade in Verarbeitung;
Band im MAREN-Katalog einer fremden Benutzerkennung zugeordnet und USER-ACCESS ungleich ALL-USERS;
Band bereits ausgeliehen;
Ausnahme: Das Band befindet sich bereits an der angegebenen Adresse. In diesem Fall wird die Verarbeitung nach Ausgabe einer Meldung normal fortgesetzt.Es wurde der Operand EXPORT-ADDRESS=*BY-CATALOG angegeben und im Katalogeintrag fehlt eine Versandanschrift;
Es sollen alle Bänder eines Tape-Sets ausgeliehen werden und einer der ausgewählten Katalogeinträge enthält das Attribut FILE-SEQUENCE > 1, d.h. die angegebene Datei ist nicht die Erste auf dem betreffenden Band;
Eines der zum Tape-Set gehörenden Bänder ist temporär gesperrt;
Das Band ist einem Lagerort mit dem Bedienmodus ROBAR-2 zugeordnet. Es kann deshalb nicht verlagert bzw. exportiert werden;
Die Bänder werden über eine Sicherungsdatei aus HSMS selektiert und es ist mindestens ein Band temporär gesperrt oder mindestens ein Band in Verarbeitung bzw. temporär gesperrt;
Die im Operand LAYOUT angegebene Datei existiert nicht.
Beispiele
|
Das Band ID0101 wird exportiert.
|
Alle Bänder, die bei der letztmaligen Erstellung der Banddatei TAPE.OUT beschrieben wurden, werden ausgeliehen. Es soll dabei die in den Katalogeinträgen dieser Bänder eingetragene Versandanschrift verwendet werden.