Diese Anweisung aktualisiert eine mit der HSMS-Anweisung EXPORT-FILES erstellte Sicherung mit einem ausgewählten Online-Datenbestand.
Die betroffenen Dateien müssen in Bezug auf den Zugriff dieselben Regeln wie bei EXPORT-FILES erfüllen. Bei fremden Dateien ist für nicht-privilegierte Benutzer der Lesezugriff ausreichend.
Die Anweisung hat ein unterschiedliches Format für nicht-privilegierte Benutzer und HSMS-Verwalter. Privilegierte Operanden bzw. Operandenwerte sind mit *P) markiert.
Format
UPDATE-EXPORT-SAVE-FILE | Alias: UES | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
*P) privilegierter Operand bzw. Operandenwert
DIRECTORY-NAME = <filename 1..54 without-gen-vers>
Für den Exportlauf wird das angegebene Verzeichnis verwendet. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein.
SAVE-FILE-ID =
Sicherungsdatei, die kopiert werden soll.
Wenn die Sicherungsdatei in eine bereits bestehene Sicherungsdatei kopiert wird (siehe Operand OUTPUT-SAVE-FILE=*CONTINUE(...)), darf die Save-File-ID nicht mit der Save-File-ID der Ausgabedatei übereinstimmen (die Voreinstellung *LATEST darf auch nicht gleichzeitig für beide Sicherungsdateien verwendet werden).
SAVE-FILE-ID = *LATEST
Die zuletzt erstellte Sicherungsdatei des Archivs wird kopiert.
SAVE-FILE-ID = <composed-name 15..15>
Die angegebene Sicherungsdatei wird kopiert. Die Save-File-ID müssen Sie in folgendem Format angeben: S.yymmdd.hhmmss
SELECT-FILES =
Legt die Dateien fest, die aus der Sicherungsdatei kopiert werden sollen.
Anmerkung
Bei einer Datei, die sowohl durch SELECT-FILES als auch durch ADD-FILES ausgewählt werden kann (d.h. die Datei ist sowohl in der Sicherungsdatei als auch auf Platte), wird die Version, die sich auf Platte befindet, kopiert.
SELECT-FILES = *ALL
Es werden alle Dateien aus der Sicherungsdatei kopiert.
SELECT-FILES = *NONE
Es werden keine Dateien aus der Sicherungsdatei kopiert.
SELECT-FILES = *SELECTED
Die Pfadnamen der Dateien, die kopiert werden sollen, werden einer Liste entnommen, welche im selben HSMS-Lauf mit der HSMS-Anweisung SELECT-FILE-NAMES erstellt wurde.
SELECT-FILES = *FROM-FILE(...)
Die Pfadnamen der Dateien, die kopiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält. Sie können diese Datei z.B. mit der HSMS-Anweisung SELECT-FILE-NAMES oder mit dem BS2000-Kommando SHOW-FILE-ATTRIBUTES erstellen.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
SELECT-FILES = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Dateien, die kopiert werden sollen, werden einem PLAM-Bibliothekselement (Typ S) entnommen. Das Bibliothekselement enthält pro Satz einen Pfadnamen. Es dürfen nur Großbuchstaben verwendet werden.
LIBRARY = <filename 1..54 without-gen-vers>
Name der PLAM-Bibliothek.
ELEMENT = <composed-name 1..64 with-under>
Name des Elements vom Typ S. Das Element mit der höchsten existierenden Version wird verwendet.
SELECT-FILES = list-poss(20): <filename 1..80 without-vers with-wild> / <partial-filename 2..79 with-wild>
Die Pfadnamen der Dateien, die kopiert werden sollen, werden direkt eingegeben. Sie können maximal 20 Namen in einer Liste eingeben.
Sie können die Dateinamen voll- oder teilqualifiziert, mit oder ohne Katalog- oder Benutzerkennung angeben. Der Dateiname wird gegebenenfalls mit der Benutzerkennung des Auftrags und der Standard-Katalogkennung der Benutzerkennung ergänzt.
Sie können die Dateien unter Verwendung der Wildcard-Syntax auswählen. Wildcards in der Benutzerkennung sind dem HSMS-Verwalter vorbehalten.
Die Wildcard-Syntax wird anhand der Dateinamen im Archivverzeichnis aufgelöst.
EXCEPT-FILES =
Sie können Dateien angeben, die nicht aus der Sicherungsdatei kopiert werden sollen. Bei Migrationsarchiven können Sie die Auswahl noch durch den Operanden MIGRATION-STATE einschränken.
EXCEPT-FILES = *NONE
Es werden alle Dateien aus der Sicherungsdatei kopiert, die beim Operanden SELECT-FILES angegeben sind.
EXCEPT-FILES = *FROM-FILE(...)
Die Pfadnamen der Dateien, die nicht kopiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält. Sie können diese Datei z.B. mit dem BS2000-Kommando SHOW-FILE-ATTRIBUTES erstellen.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
EXCEPT-FILES = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Dateien, die nicht kopiert werden sollen, werden einem PLAM-Bibliothekselement (Typ S) entnommen. Das Bibliothekselement enthält pro Satz einen Pfadnamen. Es dürfen nur Großbuchstaben verwendet werden.
LIBRARY = <filename 1..54 without-gen-vers>
Name der PLAM-Bibliothek.
ELEMENT = <composed-name 1..64 with-under>
Name des Elements vom Typ S. Das Element mit der höchsten existierenden Version wird verwendet.
EXCEPT-FILES = list-poss(20): <filename 1..80 without-vers-with-wild> / <partial-filename 2..79 with-wild>
Die Pfadnamen der Dateien, die nicht kopiert werden sollen, werden direkt eingegeben. Sie können maximal 20 Namen in einer Liste eingeben.
Die Dateinamen dürfen nicht mit einem Bindestrich beginnen. Sie können die Dateinamen voll- oder teilqualifiziert, mit oder ohne Katalog- oder Benutzerkennung angeben. Der BS2000-Dateiname wird gegebenenfalls mit der Benutzerkennung des Auftrags und der Standard-Katalogkennung ergänzt.
Sie können die Dateien unter Verwendung der Wildcard-Syntax auswählen. Wildcards in der Benutzerkennung sind dem HSMS-Verwalter vorbehalten, da nur er fremde Benutzerkennungen angeben darf. Die Wildcard-Syntax wird anhand der Dateinamen im Archivverzeichnis aufgelöst.
SELECT-JV =
Gibt die Jobvariablen an, die aus der Sicherungsdatei kopiert werden sollen. Die getroffene Auswahl gilt für alle zu kopierenden Sicherungsversionen der Sicherungsdatei.
SELECT-JV = *NONE
Es werden keine Jobvariablen aus der Sicherungsdatei kopiert.
SELECT-JV = *ALL
Es werden alle Jobvariablen aus der Sicherungsdatei kopiert.
SELECT-JV = *FROM-FILE(...)
Die Pfadnamen der Dateien, die kopiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
SELECT-JV = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Jobvariablen, die kopiert werden sollen, werden einem PLAM-Bibliothekselement (Typ S) entnommen. Das Bibliothekselement enthält pro Satz einen Pfadnamen. Es dürfen nur Großbuchstaben verwendet werden.
LIBRARY = <filename 1..54 without-gen-vers>
Name der PLAM-Bibliothek.
ELEMENT = <composed-name 1..64 with-under>
Name des Elements vom Typ S. Das Element mit der höchsten existierenden Version wird verwendet.
SELECT-JV = list-poss(20): <filename 1..80 without-gen-vers-with-wild> / <partial-filename 2..79 with-wild>
Die Pfadnamen der Jobvariablen, die kopiert werden sollen, werden direkt eingegeben. Maximal 20 Namen können Sie in einer Liste eingeben. Sie können die Jobvariablen unter Verwendung der Wildcard-Syntax auswählen.
EXCEPT-JV =
Sie können Jobvariablen angeben, die nicht aus der Sicherungsdatei kopiert werden sollen. Die Auswahl gilt für alle Sicherungsversionen der Sicherungsdatei, die kopiert werden soll.
EXCEPT-JV = *NONE
Es werden alle Jobvariablen kopiert, die beim Operanden SELECT-JV angegeben wurden.
EXCEPT-JV = *FROM-FILE(...)
Die Pfadnamen der Jobvariablen, die nicht kopiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
EXCEPT-JV = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Jobvariablen, die nicht kopiert werden sollen, werden einem PLAM-Bibliothekselement (Typ S) entnommen. Das Bibliothekselement enthält pro Satz einen Pfadnamen. Es dürfen nur Großbuchstaben verwendet werden.
LIBRARY = <filename 1..54 without-gen-vers>
Name der PLAM-Bibliothek.
ELEMENT = <composed-name 1..64 with-under>
Name des Elements vom Typ S. Das Element mit der höchsten existierenden Version wird verwendet.
EXCEPT-JV = list-poss(20): <filename 1..80 without-gen-vers with-wild> / <partial-filename 2..79 with-wild>
Die Pfadnamen der Jobvariablen, die nicht kopiert werden sollen, werden direkt eingegeben. Sie können maximal 20 Namen in einer Liste eingeben. Die Namen der Jobvariablen dürfen nicht mit einem Bindestrich beginnen.
Sie können die Jobvariablen unter Verwendung der Wildcard-Syntax auswählen.
ADD-FILES-AND-JV =
Sie können angeben, ob neben den Dateien und Jobvariablen, die über SELECT-FILES bzw. SELECT-JV aus der Sicherungsdatei kopiert werden, weitere Dateien bzw. Jobvariablen von Platte exportiert werden sollen.
ADD-FILES-AND-JV = *NO
Es werden keine Dateien oder Jobvariablen zusätzlich exportiert.
ADD-FILES-AND-JV = *YES (...)
Es werden Dateien und/oder Jobvariablen zusätzlich exportiert.
ADD-FILE-NAMES =
Es werden Dateien angeben, die exportiert werden sollen. Sie können die Auswahl noch mit den Operanden EXCEPT-FILE-NAMES und SUPPORT einschränken.
Anmerkung
Bei einer Datei, die sowohl durch SELECT-FILES als auch durch ADD-FILES ausgewählt werden kann (d.h. die Datei ist sowohl in der Sicherungsdatei als auch auf Platte), wird die Version, die sich auf Platte befindet, kopiert.
ADD-FILE-NAMES = *OWN
Es werden alle Dateien der eigenen Benutzerkennung auf allen importierten Pubsets (außer Shared-SF-Pubsets, für die der eigene Rechner Slave ist) exportiert.
ADD-FILE-NAMES = *ALL
Es werden alle Dateien auf allen importierten Pubsets (außer Shared-SF-Pubsets, für die der eigene Rechner Slave ist) exportiert.
ADD-FILE-NAMES = *NONE
Es werden keine Dateien exportiert.
ADD-FILE-NAMES = *SELECTED
Die Pfadnamen der Dateien, die exportiert werden sollen, werden einer Liste entnommen, welche im selben HSMS-Lauf mit der HSMS-Anweisung SELECT-FILE-NAMES erstellt wurde.
ADD-FILE-NAMES = *FROM-FILE(...)
Die Pfadnamen der Dateien, die exportiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält. Sie können diese Datei z.B. mit der HSMS-Anweisung SELECT-FILE-NAMES oder mit dem BS2000-Kommando SHOW-FILE-ATTRIBUTES erstellen.
ADD-LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
ADD-FILE-NAMES = list-poss(20): <filename 1..80 without-vers-with-wild> /
<partial-filename 2..79 with-wild>
Die Pfadnamen der Dateien, die exportiert werden sollen, werden direkt eingegeben. Sie können maximal 20 Namen in einer Liste eingeben.
Sie können die Dateinamen voll- oder teilqualifiziert, mit oder ohne Katalog- oder Benutzerkennung angeben. Der Dateiname wird gegebenenfalls mit der Benutzerkennung des Auftrags und der Standard-Katalogkennung der Benutzerkennung ergänzt.
Sie können die Dateien unter Verwendung der Wildcard-Syntax auswählen. Wildcards in der Benutzerkennung sind dem HSMS-Verwalter vorbehalten. Bei Katalogkennungen bezieht sich die Auflösung der Wildcard-Syntax nicht auf SF-Pubsets, für die der eigene Rechner Slave ist.
Für Dateigenerationen gilt: Wenn Sie vollqualifizierte Dateinamen angeben, können Sie auch eine Generationsnummer (Version) angeben. Nur die angegebenen Generationen werden exportiert.
EXCEPT-FILE-NAMES =
Sie können Dateien angeben, die nicht exportiert werden sollen.
EXCEPT-FILE-NAMES = *NONE
Es werden alle Dateien exportiert, die beim Operanden FILE-NAMES angegeben sind.
EXCEPT-FILE-NAMES = *FROM-FILE(...)
Die Pfadnamen der Dateien, die nicht exportiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält. Sie können diese Datei z.B. mit dem BS2000-Kommando SHOW-FILE-ATTRIBUTES erstellen.
Die Dateinamen dürfen nur in Großbuchstaben geschrieben werden.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
EXCEPT-FILE-NAMES = list-poss(20):
<filename 1..80 without-vers-with-wild> /<partial-filename 2..79 with-wild>
Die Pfadnamen der Dateien, die nicht exportiert werden sollen, werden direkt eingegeben. Sie können maximal 20 Namen in einer Liste eingeben.
Die Dateinamen dürfen nicht mit einem Bindestrich beginnen. Sie können die Dateinamen voll- oder teilqualifiziert, mit oder ohne Katalog- oder Benutzerkennung angeben. Der BS2000-Dateiname wird gegebenenfalls mit der Benutzerkennung des Auftrags und der Standard-Katalogkennung ergänzt.
Sie können die Dateien unter Verwendung der Wildcard-Syntax auswählen. Wildcards in der Benutzerkennung sind dem HSMS-Verwalter vorbehalten, da nur er fremde Benutzerkennungen angeben darf. Bei Katalogkennungen bezieht sich die Auflösung der Wildcard-Syntax nicht auf SF-Pubsets, für die der eigene Rechner Slave ist.
Für Dateigenerationen gilt: Wenn Sie vollqualifizierte Dateinamen angeben, können Sie auch eine Generationsnummer (Version) angeben. Nur die angegebenen Generationen werden exportiert.
SUPPORT =
Die zu exportierenden Dateien können Sie durch den Datenträger auswählen, auf dem sie liegen.
SUPPORT = *ANY
Die Dateien werden unabhängig von dem Datenträger exportiert, auf dem sie liegen.
SUPPORT = *PUBLIC-DISK
Es werden nur die Dateien exportiert, die sich auf gemeinschaftlichen Datenträgern befinden.
SUPPORT = *PRIVATE-DISK(...)
Es werden nur die Dateien exportiert, die sich auf Privatplatten befinden und im Katalog eines Pubsets verzeichnet (importiert) sind.
VOLUMES = *ALL
Es werden Dateien von allen (importierten) Privatplatten exportiert.
VOLUMES = list-poss(150): <vsn 1..6>
Archivnummern der Privatplatten. Es werden nur die Dateien exportiert, die mindestens ein Extent auf den angegebenen Platten haben.
SUPPORT = *TAPE
Es werden nur die Katalogeinträge von Banddateien exportiert.
ADD-JV-NAMES =
Sie können die Jobvariablen angeben, die exportiert werden sollen.
ADD-JV-NAMES = *NONE
Es werden keine Jobvariablen exportiert.
ADD-JV-NAMES = *OWN
Es werden alle Jobvariablen der eigenen Benutzerkennung auf allen importierten Pubsets (außer Shared-SF-Pubsets, für die der eigene Rechner Slave ist) exportiert.
ADD-JV-NAMES = *ALL
Es werden alle Jobvariablen auf allen importierten Pubsets (außer Shared-SF-Pubsets, für die der eigene Rechner Slave ist) exportiert.
ADD-JV-NAMES = *FROM-FILE(...)
Die Pfadnamen der Jobvariablen, die kopiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält.
ADD-LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
ADD-JV-NAMES = list-poss(20): <filename 1..80 without-vers-with-wild> /
<partial-filename 2..79 with-wild>
Die Pfadnamen der Jobvariablen, die exportiert werden sollen, werden direkt eingegeben. Sie können maximal 20 Namen in einer Liste eingeben.
Sie können die Jobvariablen unter Verwendung der Wildcard-Syntax auswählen. Bei Katalogkennungen bezieht sich die Auflösung der Wildcard-Syntax nicht auf SF-Pubsets, für die der eigene Rechner Slave ist.
EXCEPT-JV-NAMES =
Sie können Jobvariablen angeben, die nicht exportiert werden sollen.
EXCEPT-JV-NAMES = *NONE
Es werden alle Jobvariablen exportiert.
EXCEPT-JV-NAMES = *FROM-FILE(...)
Die Pfadnamen der Jobvariablen, die nicht exportiert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Die Datei muss eine SAM-Datei mit variabler Satzlänge sein, die pro Satz einen Pfadnamen enthält.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
EXCEPT-JV-NAMES = list-poss(20):
<filename 1..80 without-vers-with-wild> /<partial-filename 2..79 with-wild>
Die Pfadnamen der Jobvariablen, die nicht exportiert werden sollen, werden direkt eingegeben. Sie können maximal 20 Namen in einer Liste eingeben. Die Namen der Jobvariablen dürfen nicht mit einem Bindestrich beginnen.
Sie können die Jobvariablen unter Verwendung der Wildcard-Syntax auswählen. Bei Katalogkennungen bezieht sich die Auflösung der Wildcard-Syntax nicht auf SF-Pubsets, für die der eigene Rechner Slave ist.
SAVE-SAM-STRUCTURE = *YES/*NO
Legt fest, ob die Struktur der SAM-Knotendateien gespeichert werden soll.
Ohne SAM-Struktur gespeicherte SAM-Knotendateien können nur als SAM-Knotendatei restauriert werden.
Mit SAM-Struktur gespeicherte SAM-Knotendateien können entweder als FILE-TYPE=*BS2000 (im öffentlichen Bereich oder Speichernetz) oder als FILE-TYPE=*NODE-FILE restauriert werden.
PASSWORDS = *NONE / *SECRET-PROMPT / list-poss(63): <c-string 1..4> /
<x-string 1..8> / <integer -2147483648..2147483647>
Wenn eine Datei oder Jobvariable, die über ADD-FILE-NAMES exportiert oder über SELECT-FILES ersetzt werden soll, mit einem Lesekennwort geschützt ist, dann muss dieses hier angegeben werden. Ein HSMS-Verwalter kann Dateien und Jobvariablen auch ohne Angabe der Kennwörter exportieren.
Wenn eine kennwortgeschützte Sicherungsdatei aktualisiert werden soll, ist das Kennwort hier auch anzugeben. Der Operand PASSWORDS hat folgende Besonderheiten:
Eingegebene Werte werden nicht protokolliert.
Im geführten Dialog ist das Eingabefeld automatisch dunkelgesteuert.
Bei Angabe von *SECRET oder ^ stellt SDF im ungeführten Dialog und in Vordergrundprozeduren ein dunkelgesteuertes Eingabefeld zur verdeckten Eingabe des Kennwortes zur Verfügung.
COMPRESS-FILES = *NO / *YES
Bestimmt, ob die Daten vor dem Schreiben auf den Ausgabedatenträger komprimiert werden sollen oder nicht.
SAVE-DIRECTORY = *NO / *YES
Bestimmt, ob das Verzeichnis am Ende des Exportlaufs als letzte Datei auf den Export-Datenträger geschrieben wird oder nicht.
OUTPUT-SAVE-FILE =
Legt die Sicherungsdatei fest, in der die exportierten Dateien abgelegt werden sollen.
OUTPUT-SAVE-FILE = *NEW(...)
Die exportierten Dateien werden in einer neu zu erstellenden Sicherungsdatei abgelegt. Für die Sicherungsdatei können Sie folgende Attribute festlegen:
RETENTION-PERIOD = 0 / <integer 0..16383 days >
Physische Schutzfrist in Tagen. Während dieser Schutzfrist dürfen die Sicherungsdatei und -datenträger nicht verändert oder gelöscht werden.
USER-ACCESS = *ALL-USERS
Die Sicherungsdatei wird mehrbenutzbar angelegt. Die Daten können auf einer anderen Benutzerkennung importiert werden.
USER-ACCESS = *OWNER-ONLY
Die Sicherungsdatei wird nicht mehrbenutzbar angelegt. Die Daten können nur unter derselben Benutzerkennung importiert werden.
SAVE-FILE-PASSWORD = *NONE / *SECRET-PROMPT / <c-string 1..4> /
<x-string 1..8> / <integer -2147483648..2147483647>
Für die zu erstellende Sicherungsdatei können Sie ein Kennwort vergeben, das beim Fortschreiben oder Importieren anzugeben ist.
Der Operand SAVE-FILE-PASSWORD hat folgende Besonderheiten:
Eingegebene Werte werden nicht protokolliert.
Im geführten Dialog ist das Eingabefeld automatisch dunkelgesteuert.
Bei Angabe von *SECRET oder ^ stellt SDF im ungeführten Dialog und in Vordergrundprozeduren ein dunkelgesteuertes Eingabefeld zur verdeckten Eingabe des Kennwortes zur Verfügung.
OUTPUT-SAVE-FILE = *CONTINUE(...)
Die nachfolgend näher bestimmbare Sicherungsdatei wird fortgeschrieben.
Die Sicherungsdatei, aus der kopiert wird, darf nicht angegeben werden (siehe Operand SAVE-FILE-ID). Die Voreinstellung *LATEST darf auch nicht gleichzeitig für beide Sicherungsdateien verwendet werden.
SAVE-FILE-ID = *LATEST
Die zuletzt erstellte Sicherungsdatei wird fortgesetzt.
SAVE-FILE-ID = <composed-name 15..15>
Die angegebene Sicherungsdatei wird fortgesetzt. Die Save-File-ID müssen Sie in folgendem Format angeben: S.yymmdd.hhmmss
TO-STORAGE = *TAPE(...)
Die Dateien werden auf Magnetband exportiert. Die Datenträger können näher bestimmt werden. Wenn Sie mehrere Datenträger angeben, müssen alle vom selben Gerätetyp sein.
VOLUMES = *FROM-POOL
Die Datenträger werden dem Datenträger-Pool des angegebenen Verzeichnisses oder dem zugeordneten MAREN-Pool entnommen.
VOLUMES = *FROM-OPERATOR
Der Operator weist die Datenträger bei Anforderung zu.
VOLUMES = list-poss(100): <vsn 1..6>
Liste von Archivnummern, die in der angegebenen Reihenfolge angefordert werden.
DEVICE-TYPE = *STD / <device>
Gerätetyp der angeforderten Datenträger. Sie müssen einen Datenträger der Klasse „TAPE“ angeben. Es werden nur Gerätetypen akzeptiert, die im System bekannt sind. Im Dialog werden mit DEVICE-TYPE=? die möglichen Gerätetypen angezeigt.
Bei OUTPUT-SAVE-FILE=NEW(...) ist der Standardwert der Wert, der mit dem Operanden S2-DEVICE-TYPE der Anweisung MODIFY-HSMS-PARAMETERS festgelegt wurde, bei OUTPUT-SAVE-FILE=CONTINUE(...) ist es der zuvor benutzte Wert.
LOCATION = *ANY / <alphanum-name 1..8>
Lagerort, der zum Anfordern von Datenträgern verwendet wird. Der Lagerort muss MAREN bekannt sein. Falls der Location Manager eingesetzt wird, muss der Lagerort in MARENLM korrekt definiert sein. Andernfalls ignoriert MAREN den angegebenen Wert.
Wenn MAREN nicht im Einsatz ist, müssen Sie für LOCATION den Wert *ANY angeben.
LOCATION = *ANY
Es soll kein Lagerort verwendet werden.
TO-STORAGE = *PUBLIC-DISK(...)
Dieser Operandenwert steht nur dem HSMS-Verwalter zur Verfügung.
Die Sicherungsdatei wird auf ein Pubset exportiert.
PUBSET-ID = <cat-id>
Katalogkennung des Pubsets
TO-STORAGE = *NET-STORAGE(...)
Die Sicherungsdatei wird auf ein Net-Storage exportiert.
VOLUMES = list-poss(16): <vsn 1..6>
Gibt das Net-Storage-Volume an, auf das die Dateien kopiert werden. Das angegebene Volume muss zugreifbar sein. In einer Liste können auch mehrere Net-Storage-Volumes angegeben werden (z.B. bei mehreren Sicherungstasks).
OPERATION-CONTROL =
Sie können Parameter für den Ablauf dieses Exportlaufs festlegen.
OPERATION-CONTROL = *STD
Es gilt jeweils der Standardwert der nachstehend beschriebenen Operanden.
OPERATION-CONTROL = *PARAMETERS(...)
Sie können folgende Operanden für die Steuerung des Exportlaufs ändern:
REQUEST-NAME = *STD / <name 1..8>
Auftragsname, über den Sie den Auftrag bei den HSMS-Anweisungen zur Auftragsverwaltung (DELETE-REQUESTS, RESTART-REQUESTS und SHOW-REQUESTS) ansprechen können.
Der Name wird intern ergänzt durch Voranstellen eines Präfixes, das aus der Benutzerkennung abgeleitet wird (oder durch SYSHSMS beim HSMS-Verwalter) und Anhängen eines Zeitstempels.
Standardmäßig wird der Auftragsname gebildet aus dem Kürzel „UES#“ und der TSN des aufrufenden Benutzerauftrags yyyy in der Form: UES#yyyy.
REQUEST-DESCRIPTOR = *NONE / <text 1..60>
Es kann ein beliebiger Text angegeben werden, der den Auftrag näher beschreibt. Dieser Text wird an der Konsole des Operators angezeigt, wenn der Auftrag gestartet wird. Der Text wird bei der HSMS-Anweisung SHOW-REQUESTS ausgegeben.
EXPRESS-REQUEST = *NO / *YES
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Bestimmt, ob der Bandzugriff zu den Zeiten erfolgen soll, die für Expressaufträge festgelegt wurden.
CONTROL-JV = *NONE / <filename 1..54 without-gen-vers>
Gibt den Namen einer Jobvariablen an, die von HSMS gesetzt wird und welche verschiedene Werte annehmen kann.
Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Jobvariablen sein. Der Auftragserteiler kann die Jobvariable abfragen, um sich einen Überblick über den aktuellen Bearbeitungsstand zu verschaffen. Im Handbuch „HSMS Bd. 1“ [1] ist im Abschnitt „Jobvariable zur Auftragsüberwachung“ ausführlich beschrieben, wie Sie die Jobvariable verwenden können.
WAIT-FOR-COMPLETION = *NO / *YES
Bestimmt, ob der Benutzer auf die Beendigung seines Auftrags warten will (synchrone Verarbeitung) oder nach dem Prüfen der HSMS-Anweisung auf Gültigkeit die Kontrolle zurückerhalten will (asynchrone Verarbeitung).
Die maximale Wartezeit für Stapel- und Dialogaufträge ist unterschiedlich und wird durch globale HSMS-Parameter vorgegeben.
Für Dialogaufträge ist die synchrone Ausführung der HSMS-Anweisungen nur während der Bandverarbeitungszeiten zugelassen.
CATALOG-ID-MODE = *YES / *NO
Bestimmt, ob die Daten mit oder ohne Katalogkennung in die Sicherungsdatei geschrieben werden (entsprechend CATID-Parameter bei ARCHIVE).
PARALLEL-RUNS = 1 / <integer 1..16>
Anzahl der gleichzeitig ablaufenden Sicherungstasks (ARCHIVE-Subtasks).
Für jede Task müssen zwei Bandgeräte zur Verfügung stehen.
Standardmäßig läuft nur eine Sicherungstask.
Nähere Informationen zur parallelen Verarbeitung finden Sie im Handbuch „HSMS Bd. 1“ [1].
WRITE-CHECKPOINTS = *YES / *NO
Bestimmt, ob während der Verarbeitung Wiederaufsetzpunkte in die ARCHIVE-Checkpointdatei geschrieben werden sollen, die bei einem Abbruch (Status INTERRUPTED) einen späteren Wiederanlauf ermöglichen.
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
OPERATOR-INTERACTION = *NOT-ALLOWED / *ALLOWED
Sie können festlegen, ob Meldungen, die eine Antwort des Operators erfordern, am Bedienplatz ausgegeben werden sollen (*ALLOWED) oder nicht (*NOT-ALLOWED). Bei *NOT-ALLOWED führt HSMS statt dessen eine Standardbehandlung durch (siehe Handbuch „ARCHIVE“ [2], PARAM-Anweisung).
TAPE-CONTROL =
Sie können Parameter für den Export auf Magnetband festlegen.
TAPE-CONTROL = *STD
Es gilt jeweils der Standardwert der nachstehend beschriebenen Operanden.
TAPE-CONTROL = *PARAMETERS(...)
Sie können folgende Parameter für den Export auf Magnetband ändern:
BLOCKING-FACTOR = *STD / <integer 15..15 2Kbyte > / *MAX
Blockungsfaktor, mit dem die Sicherungsdatei auf Magnetband geschrieben wird. Es wird die Anzahl der 2-Kbyte-Blöcke (PAM-Seiten) angegeben, die mit einer Ein-/Ausgabe auf Magnetband geschrieben werden. Da sich mit einem höheren Blockungsfaktor der Füllungsgrad des Datenträgers und die Performance der Bandverarbeitung verbessern, sollten Werte kleiner 15 nicht gewählt werden.
Mit der Voreinstellung *STD gilt die Voreinstellung der ARCHIVE-Parameter (BLOCK-SIZE-TAPE für Langband, BLOCK-SIZE-T-C für Magnetbandkassetten).
*MAX wählt den Blockungsfaktor, der in der aktuellen BS2000-Version maximal möglich ist. Zurzeit ist dieser Wert 128.
UNLOAD-TAPE = *NO / *YES
Bestimmt, ob ein Magnetband nach dem Ende der Verarbeitung entladen wird oder nicht.
PERFORMANCE-ANALYSIS =
Für jeden ARCHIVE-Subtask kann eine Statistikdatei erstellt werden. ARCHIVE schreibt eine neue Zeile in diese Statistikdatei:
wenn es eine Sicherungsdatei ARCHIVE.SAVE.FILE öffnet.
wenn es diese Sicherungsdatei schließt.
jedes Mal wenn es mit dem Sichern oder Restaurieren einer neuen Datei beginnt.
alle 2 Sekunden während des Sicherns/Restaurierens.
Dadurch erhalten Sie einen detaillierten Überblick über die ARCHIVE-Aktivitäten während des Sicherns und Restaurierens.
PERFORMANCE-ANALYSIS = *NO
Es wird keine Statistikdatei erstellt.
PERFORMANCE-ANALYSIS = *YES(...)
Für jeden ARCHIVE-Subtask wird eine Statistikdatei erstellt.
SEPARATOR = ; / <c-string 1..1>
Zeichen, das zwischen die verschiedenen Felder in den Statistikdateien eingefügt wird. Dadurch können Programme wie EXCEL oder LOTUS die verschiedenen Felder unterscheiden.
Standardwert ist „ ; “. Dies entspricht der Voreinstellung von EXCEL.
REPORT =
Bestimmt, ob und in welchem Umfang ein Report für den Exportauftrag ausgegeben werden soll.
REPORT = *SUMMARY
Ausgegeben wird eine Zusammenfassung des Ergebnisses des Exportauftrags mit eventuellen Fehlermeldungen.
REPORT = *FULL
Ausgegeben wird ein Report in vollem Umfang mit einer Liste aller exportierten Dateien.
REPORT = *NONE
Es wird kein Report ausgegeben.
OUTPUT =
Bestimmt, wohin der Report ausgegeben werden soll.
OUTPUT = *STD
Den Ausgabeort des Reports bestimmen die Standardeinstellungen, festgelegt durch den globalen HSMS-Parameter OUTPUT.
OUTPUT = *PRINTER
Der Report des Exportauftrags wird auf Drucker ausgegeben.
OUTPUT = *NONE
Es wird kein Report ausgegeben. Unabhängig davon steht der Report als PDF-Datei über die SE Manager-Anwendung Backup Monitoring zur Verfügung, wenn das Monitoring in den globalen HSMS-Parametern aktiviert ist.
OUTPUT = *MAIL
Der Report des Exportauftrags wird als Anhang einer E-Mail an die Adresse geschickt, die im Benutzereintrag des Aufrufers eingetragen ist. Wenn das Versenden per E-Mail nicht möglich ist, wird der Report auf Drucker ausgegeben.
OUTPUT = *LIBRARY-ELEMENT(...)
Der Report des Exportauftrags wird druckaufbereitet in das angegebene PLAM-Bibliothekselement (Typ P) ausgegeben. Wenn diese Ausgabe nicht möglich ist, wird der Report auf Drucker ausgegeben.
LIBRARY = <filename 1..54 without-gen-vers>
Name der PLAM-Bibliothek.
ELEMENT = <composed-name 1..64 with-under>
Name des Elements. Erzeugt wird ein Element vom Typ P mit einer Version, die die Benutzerkennung sowie Datum und Zeit enthält.
OUTPUT = <filename 1..54 without-gen-vers>
Der Report des Exportauftrags wird druckaufbereitet in die angegebene Datei geschrieben.
Wenn diese Datei bereits existiert, dann gilt:
Wenn sie nicht leer und eine SAM-Datei ist, wird sie fortgeschrieben.
Andernfalls wird der Report auf Drucker ausgegeben.
Bei nicht-privilegierten Aufrufern muss die Reportdatei unter der eigenen Benutzerkennung liegen. Anderenfalls muss Miteigentümerschaft bestehen.