Diese Anweisung holt BS2000-Dateien und Jobvariablen aus einem Backup-, Versions-Backup- oder Langzeit-Archiv auf die Verarbeitungsebene zurück. Sie können dabei die Dateien und Jobvariablen umbenennen, reorganisieren und auf andere Datenträger schreiben. Sie können die Sicherungsdateien und -versionen auswählen, aus denen die Dateien und Jobvariablen zurückgeholt (restauriert) werden.
Die Anweisung hat ein unterschiedliches Format für nicht-privilegierte Benutzer und HSMS-Verwalter. Privilegierte Operanden bzw. Operandenwerte sind mit *P) markiert.
Format
RESTORE-FILES | Alias: RSF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
*P) privilegierter Operand bzw. Operandenwert
FILE-NAMES =
Sie müssen die Dateien angeben, die restauriert werden sollen. Dieser Operand muss angegeben werden. Sie können die Auswahl noch mit den Operanden EXCEPT-FILE-NAMES, DIALOG-FILE-SELECT und ORIGINAL-SUPPORT (nur für HSMS-Verwalter) einschränken.
Eine Datei kann nur auf einem verfügbaren Pubset restauriert werden und nur, wenn die Benutzerkennung einen Eintrag im Benutzerkatalog dieses Pubsets besitzt.
Dieses Verhalten können Sie mit einem optionalen Rep wie folgt ändern: Wenn auf dem verfügbaren Pubset eine Benutzerkennung fehlt, wird sie automatisch im Benutzerkatalog des Pubsets eingetragen und die Dateien können somit angelegt werden. Eine Meldung weist auf die neu eingerichtete Benutzerkennung hin.
Wenn Sie Dateien aus mehreren Pubsets angeben und diese aus einem Standard-Systemarchiv geholt werden sollen, muss allen Pubsets dasselbe Standard-Systemarchiv zugewiesen sein. Sonst wird die HSMS-Anweisung zurückgewiesen. Um dies zu vermeiden, sollten Sie in jedem Restore-Auftrag nur Dateien eines einzigen Pubsets angeben.
Jeder nicht-privilegierte Benutzer kann auch Dateien von anderen Benutzerkennungen restaurieren, wenn er Miteigentümer dieser Dateien ist.
Es gibt keine globalen Standard-Systemarchive für Versions-Backup, nur pro Pubset zugeordnete SYSVERSION-Backup-Archive. Ein SYSVERSION-Archiv kann nur einem Pubset zugewiesen werden sein.
FILE-NAMES = *OWN
Es werden alle Dateien restauriert, die im Archivverzeichnis enthalten sind und der eigenen Benutzerkennung angehören.
FILE-NAMES = *ALL
Es werden alle Dateien restauriert, die im Archivverzeichnis enthalten sind.
FILE-NAMES = *NONE
Es werden keine Dateien restauriert.
FILE-NAMES = *SELECTED
Die Pfadnamen der Dateien, die restauriert werden sollen, werden einer Liste entnommen, welche im selben HSMS-Lauf mit der HSMS-Anweisung SELECT-FILE-NAMES erstellt wurde.
FILE-NAMES = *FROM-FILE(...)
Die Pfadnamen der Dateien, die restauriert 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. Es dürfen nur Großbuchstaben verwendet werden. 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.
FILE-NAMES = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Dateien, die restauriert 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.
FILE-NAMES = list-poss(20): <filename 1..80 without-vers-with-wild> / <partial-filename 2..79 with-wild>
Die Pfadnamen der Dateien, die restauriert 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 ergänzt mit der Benutzerkennung des Auftraggebers und mit der Katalogkennung, die entweder von der angegebenen Umgebung oder von der Standard-Katalogkennung der Benutzerkennung genommen wird.
Sie können die Dateien unter Verwendung der Wildcard-Syntax auswählen. Die Wildcard-Syntax wird anhand der Dateinamen im Archivverzeichnis aufgelöst.
Restaurierungen laufen schneller ab, wenn Sie vollqualifizierte Dateinamen verwenden.
Für Dateigenerationen gilt: Wenn Sie vollqualifizierte Dateinamen angeben, können Sie auch eine Generationsnummer (Version) angeben. Nur die angegebenen Generationen werden restauriert.
EXCEPT-FILE-NAMES =
Sie können Dateien angeben, die nicht restauriert werden sollen.
EXCEPT-FILE-NAMES = *NONE
Alle Dateien, die beim Operanden FILE-NAMES angegeben sind, werden restauriert.
EXCEPT-FILE-NAMES = *FROM-FILE(...)
Die Pfadnamen der Dateien, die nicht restauriert werden sollen, werden einer Datei entnommen. Der nicht-privilegierte Aufrufer muss Eigentümer oder Miteigentümer dieser Datei sein. Es dürfen nur Großbuchstaben verwendet werden. 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-FILE-NAMES = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Dateien, die nicht restauriert 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-FILE-NAMES = list-poss(20): <filename 1..80 without-vers-with-wild> /
<partial-filename 2..79 with-wild>
Die Pfadnamen der Dateien, die nicht restauriert 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 Dateiname wird gegebenenfalls ergänzt mit der Benutzerkennung des Auftraggebers und mit der Katalogkennung, die entweder von der angegebenen Umgebung oder von der Standard-Katalogkennung der Benutzerkennung genommen wird.
Sie können die Dateien unter Verwendung der Wildcard-Syntax auswählen. Die Wildcard-Syntax wird anhand der Dateinamen im Archivverzeichnis aufgelöst.
Für Dateigenerationen gilt: Wenn Sie vollqualifizierte Dateinamen angeben, können Sie auch eine Generationsnummer (Version) angeben. Nur die angegebenen Generationen werden nicht restauriert.
NEW-FILE-NAMES =
Sie können die Dateien vor der Restaurierung umbenennen. Sie müssen selbst dafür sorgen, dass der neue Pfadname den Regeln des BS2000 entspricht. Die Gesamtlänge darf 54 Zeichen nicht überschreiten, d.h. der Dateiname ohne Benutzer- und Katalogkennung sollte nur 38 Zeichen betragen (wegen der Erweiterung der Katalogkennung). Der neue Dateiname wird folgendermaßen gebildet:
:cat-id:$user-id.<prefix>.old-filename-without-cat-user.<suffix>
NEW-FILE-NAMES = *SAME
Die Dateien werden unter ihrem Originalnamen restauriert.
NEW-FILE-NAMES = *BY-RULE(...)
Die Dateien werden nach einer einheitlichen Vorschrift umbenannt.
Wenn Sie beim Operanden MIGRATED-FILES den Wert *CATALOG-ONLY angeben, dürfen Sie nur die Unteroperanden NEW-CATALOG-ID und NEW-USER-ID angeben; die Unteroperanden PREFIX und SUFFIX sind in diesem Fall nicht erlaubt.
NEW-CATALOG-ID = *SAME / <cat-id>
Sie können die Dateien unter einer anderen Katalogkennung restaurieren. Die Katalogkennung muss ohne Doppelpunkte angegeben werden. Die Benutzerkennung muss in diesem Katalog eingetragen sein.
Standardmäßig werden die Dateien unter der ursprünglichen Katalogkennung restauriert.
NEW-USER-ID = *SAME / <name 1..8>
Sie können die Dateien unter einer anderen Benutzerkennung restaurieren. Die Benutzerkennung muss ohne führendes $-Zeichen angegeben werden.
Standardmäßig werden die Dateien unter der ursprünglichen Benutzerkennung restauriert.
PREFIX = *NONE / <filename 1..8 without-cat-user-gen-vers>
Sie können dem Dateinamen ein maximal 8 Zeichen langes Präfix voranstellen. Es wird automatisch durch einen Punkt vom Dateinamen getrennt (Teilqualifizierung).
In dem Präfix sind nur Zeichen erlaubt, die auch in einem Dateinamen vorkommen dürfen.
Standardmäßig erhalten die Dateien kein Präfix.
SUFFIX = *NONE / <composed-name 1..8>
Sie können an den Dateinamen ein maximal 8 Zeichen langes Suffix anfügen. Es wird automatisch durch einen Punkt vom Dateinamen getrennt (Teilqualifizierung).
Es sind nur Zeichen erlaubt, die auch in einem Dateinamen vorkommen dürfen.
Standardmäßig erhalten die Dateien kein Suffix.
ENVIRONMENT =
HSMS-Umgebung, in der diese HSMS-Anweisung gültig ist.
ENVIRONMENT = *STD
Bedeutung für privilegierte Benutzer: *STD wird auf den Wert *SINGLE-FEATURE gesetzt.
Bedeutung für nicht-privilegierte Benutzer: *STD ist die Umgebung, die mit dem Standard-Pubset des Benutzers verknüpft ist (der Standard-Pubset ist im Benutzerkatalog definiert).
ENVIRONMENT = *SINGLE-FEATURE
Die HSMS-Anweisung betrifft die SF-Umgebung.
ENVIRONMENT = *SYSTEM-MANAGED(...)
Die HSMS-Anweisung betrifft die angegebene SM-Pubset-Umgebung.
CATALOG-ID = <cat-id>
Katalogkennung des SM-Pubsets, für den die HSMS-Anweisung gültig ist.
ORIGINAL-SUPPORT =
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Dieser Operand ist nur in einer SF-Pubset-Umgebung gültig.
Sie können die zu restaurierenden Dateien durch den Datenträger auswählen, auf dem sie vor der Sicherung lagen.
ORIGINAL-SUPPORT = *ANY
Die Dateien werden unabhängig von dem Datenträger restauriert, von dem sie stammen.
ORIGINAL-SUPPORT = *PUBLIC-DISK(...)
Es werden nur die Dateien restauriert, die von gemeinschaftlichen Datenträgern (Pubset und ggf. zugeordneter Net-Storage) stammen.
STORAGE-TYPE =
Wählt den Speichertyp des gemeinschaftlichen Datenträgers aus, auf dem die Dateien liegen.
STORAGE-TYPE = *ANY
Die Dateien von gemeinschaftlichen Datenträgern werden unabhängig vom Speichertyp restauriert. Die Dateien können von den Platten eines Pubsets oder von einem Net-Storage stammen.
STORAGE-TYPE = *PUBLIC-SPACE
Es werden nur Dateien restauriert, die von den Platten eines Pubsets stammen. Dateien von einem Net-Storage werden nicht berücksichtigt.
STORAGE-TYPE = *NET-STORAGE(...)
Es werden nur Dateien restauriert, die von einem Net-Storage stammen.
VOLUMES = *ALL / list-poss(150): <vsn 1..6>
Gibt die VSN eines oder mehrerer Net-Storage-Volumes an, von dem die zu restaurierenden Dateien stammen. *ALL wählt alle Net-Storage-Volumes aus.
FILE-TYPE =
Wählt den Dateityp der zu restaurierenden Net-Storage-Dateien aus.
FILE-TYPE = *ANY
Die Dateien werden unabhängig vom Speichertyp ausgewählt.
FILE-TYPE = *BS2000
Nur Net-Storage-Dateien von Dateityp BS2000 werden ausgewählt.
FILE-TYPE = *NODE-FILE
Nur Net-Storage-Dateien von Dateityp Node-File werden ausgewählt.
ORIGINAL-SUPPORT = *PRIVATE-DISK(...)
Es werden nur die Dateien restauriert, die von Privatplatten stammen.
VOLUMES = list-poss(150): <vsn 1..6>
Archivnummern der Privatplatten.
NEW-SUPPORT =
Bestimmt die Datenträger, auf die die restaurierten Dateien zurückgeschrieben werden.
NEW-SUPPORT = *STD
Die Dateien aus Backup-Archiven werden auf die Datenträger zurückgeschrieben, von denen sie stammen. Aus anderen Archivtypen werden die Dateien auf gemeinschaftliche Datenträger geschrieben. Net-Storage-Dateien, die ursprünglich auf Volumes vom Typ NETVOL gespeichert waren, können nur auf Systemen ab BS2000 V21.0A restauriert werden.
NEW-SUPPORT = *PUBLIC-DISK(...)
Die Dateien werden auf gemeinschaftliche Datenträger (Pubset oder zugeordneter Net-Storage) zurückgeschrieben. Net-Storage-Volumes vom Typ NETVOL werden erst ab BS2000 V21.0A unterstützt.
STORAGE-TYPE =
Wählt den Speichertyp des gemeinschaftlichen Datenträgers aus, auf dem die Dateien liegen.
STORAGE-TYPE = *STD
Die ursprünglich auf gemeinschaftlicher Platte gespeicherten Dateien werden auf dem ursprünglichen Speichermedium restauriert; ursprünglich auf Privatplatten gespeicherte Dateien werden auf gemeinschaftlichen Datenträgern restauriert. Net-Storage-Dateien, die ursprünglich auf Volumes vom Typ NETVOL gespeichert waren, können nur auf Systemen ab BS2000 V21.0A restauriert werden.
STORAGE-TYPE = *PUBLIC-SPACE
Die Dateien werden nur auf Platten des jeweiligen Pubsets zurückgeschrieben.
STORAGE-TYPE = *NET-STORAGE(...)
Die Dateien werden nur auf den Net-Storage, der dem jeweiligen Pubset zugeordnet ist, zurückgeschrieben.
VOLUME = <vsn 1..6>
Gibt die VSN des Net-Storage-Volumes an, auf das die Dateien zurückgeschrieben werden. Net-Storage-Volumes vom Typ NETVOL werden auf BS2000-Systemen < V21.0A abgelehnt. Wenn die wiederherzustellenden Dateien aus dem Pubset stammen, das nicht dem angegebenen Net-Storage-Volume zugeordnet ist, sollten sie mit NEW-FILE-NAMES = * BY-RULE (NEW-CATALOG-ID = <cat-id>) umbenannt werden. Dabei ist cat-id die catid des Pubsets, der dem angegebenen Net-Storage-Volume zugeordnet ist.
FILE-TYPE =
Gibt an, in welchem Dateityp die Dateien auf dem Net-Storage restauriert werden.
FILE-TYPE = *STD
Die Dateien werden in ihrem ursprünglichen Dateityp restauriert.
FILE-TYPE = *BS2000
Die Dateien werden im Dateityp BS2000 restauriert.
FILE-TYPE = *NODE-FILE
Die Dateien werden im Dateityp Node-File restauriert.
NEW-SUPPORT = *PRIVATE-DISK(...)
Die Daten werden auf Privatplatten zurückgeschrieben. Alle Platten müssen vom selben Gerätetyp sein.
VOLUMES = list-poss(150): <vsn 1..6>
Archivnummern der Privatplatten.
DEVICE-TYPE = STDDISK / <device>
Gerätetyp der Privatplatten. Mit der Voreinstellung STDDISK wird der Standard-Gerätetyp verwendet. Es werden nur Gerätetypen akzeptiert, die im System bekannt sind. Im Dialog werden mit DEVICE-TYPE=? die möglichen Gerätetypen angezeigt.
NEW-SUPPORT = *SYSTEM-MANAGED-PUBSET(...)
Die Dateien werden auf einen SM-Pubset zurückgeschrieben (Pubset oder zugeordneter Net-Storage).
STORAGE-CLASS =
Speicherklasse, mit der die Dateien zurückgeschrieben werden.
STORAGE-CLASS = *ORIGINAL
Dateien, die von SM-Pubsets gesichert wurden, werden mit ihrer ursprünglichen Speicherklasse zurückgeschrieben.
Dateien, die von SF-Pubsets gesichert wurden, werden ohne Speicherklasse zurückgeschrieben.
STORAGE-CLASS = *STD
Die Dateien werden mit der Speicherklasse zurückgeschrieben, die für Benutzer Standard ist (mit denselben Regeln, die das DMS bei einem /CREATE-FILE mit STORAGE-CLASS=*STD anwendet).
STORAGE-CLASS = *NONE(...)
Die Dateien werden ohne Speicherklasse zurückgeschrieben.
VOLUME-SET-ID =
In einer SM-Pubset-Umgebung können Sie das Volume-Set angeben, auf das die Dateien zurückgeschrieben werden sollen.
VOLUME-SET-ID = *BEST-VOLUME-SET
Die zu restaurierenden Dateien werden in Bezug auf ihre Dateiattribute auf das beste Volume-Set zurückgeschrieben. Bei der Bestimmung des besten Volume-Sets werden S1-Volume-Sets nicht berücksichtigt.
VOLUME-SET-ID = *ORIGINAL
Dieser Wert ist nur erlaubt, wenn der Benutzer das Privileg für physikalische Allokierung in dem SM-Pubset hat und wenn die Dateien auf denselben SM-Pubset zurückgeschrieben werden.
Die Dateien werden auf denselben Volume-Set zurückgeschrieben, von dem sie stammen.
VOLUME-SET-ID = <cat-id>
Wenn in einer SM-Pubset-Umgebung gearbeitet wird, kann ein Benutzer, der die Berechtigung zur Dateizuweisung (siehe Benutzerattribute) besitzt, die Katalogkennung eines Volume-Sets in einem SM-Pubset angeben. Die Angabe eines S1-Volume-Sets ist erlaubt.
STORAGE-TYPE =
Wählt den Speichertyp für gemeinschaftliche Datenträger aus.
STORAGE-TYPE = *STD
Die Dateien werden auf gemeinschaftliche Datenträger restauriert.
STORAGE-TYPE = *PUBLIC-SPACE
Die Dateien werden nur auf Platten des jeweiligen Pubsets zurückgeschrieben.
STORAGE-TYPE = *NET-STORAGE(...)
Die Dateien werden nur auf den Net-Storage, der dem jeweiligen Pubset zugeordnet ist, zurückgeschrieben.
VOLUME = <vsn 1..6>
Gibt die VSN des Net-Storage-Volumes an, auf das die Dateien zurückgeschrieben werden. Net-Storage-Volumes vom Typ NETVOL werden auf BS2000-Systemen < V21.0A abgelehnt.
FILE-TYPE =
Gibt an, in welchem Dateityp die Dateien auf dem Net-Storage restauriert werden.
FILE-TYPE = *STD
Die Dateien werden in ihrem ursprünglichen Dateityp restauriert.
FILE-TYPE = *BS2000
Die Dateien werden im Dateityp BS2000 restauriert.
FILE-TYPE = *NODE-FILE
Die Dateien werden im Dateityp Node-File restauriert.
MIGRATED-FILES =
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Gibt das RESTORE-Verfahren für migrierte Dateien an. Das sind Dateien, die als „migriert“ in das Backup-Archiv oder Versions-Backup-Archiv gesichert wurden.
Nur ein HSMS-Verwalter kann zwischen den Operandenwerten wählen. Für nicht-privilegierte Benutzer gilt immer der Operandenwert *DATA-AND-CATALOG.
MIGRATED-FILES = *DATA-AND-CATALOG
Die migrierten Dateien werden mit Daten nach S0 restauriert. Für migrierte Dateien, bei denen nur der Katalogeintrag, nicht aber die Daten im Backup-Archiv vorhanden sind, wird der Katalogeintrag restauriert. Anschließend werden mit einem RECALL-Vorgang die Daten aus dem Migrationsarchiv nach S0 geholt. Wenn dabei keine Daten im Migrationsarchiv gefunden werden, wird der Katalogeintrag gelöscht; die Datei wird als nicht restaurierbar gemeldet.
MIGRATED-FILES = *CATALOG-ONLY
Für alle migrierten Dateien wird nur der Katalogeintrag restauriert. Anschließend werden die Katalogeinträge so modifiziert, dass sie auf die jüngsten passenden Daten im Migrationsarchiv zeigen. Wenn im Migrationsarchiv für eine Datei keine passenden Daten vorhanden sind, wird dies als Fehler gemeldet. Der Katalogeintrag bleibt dabei bestehen.
NET-STORAGE-FILES = *DATA-AND-CATALOG / *CATALOG-ONLY
Gibt an, ob für Dateien auf Net-Storage nur der Katalogeintrag oder auch die Daten restauriert werden sollen. Voreingestellt ist *DATA-AND-CATALOG, d.h. es werden Daten und Katalogeintrag restauriert.
Dieser Operand kann nur für Net-Storage-Dateien vom Typ BS2000 und Net-Storage-Volumes vom Typ NETSTOR sinnvoll verwendet werden. Net-Storage-Dateien vom Typ Node-File werden immer mit Daten restauriert. Ebenso Dateien auf Net-Storage-Volumes vom Typ NETVOL.
JV-NAMES =
Sie können die Jobvariablen angeben, die restauriert werden sollen. Eine Jobvariable kann nur auf einem verfügbaren Pubset restauriert werden und nur, wenn die Benutzerkennung einen Eintrag im Benutzerkatalog für diesen Pubset besitzt.
Wenn Sie Jobvariablen aus mehreren Pubsets angeben und diese aus einem Standard-Systemarchiv geholt werden sollen, muss allen Pubsets dasselbe Standard-Systemarchiv zugewiesen sein. sonst wird die HSMS-Anweisung zurückgewiesen. Um dies zu vermeiden, sollten Sie in jedem Auftrag nur Jobvariablen eines einzigen Pubsets angeben.
Jeder nicht-privilegierte Benutzer kann auch Jobvariablen von anderen Benutzerkennungen restaurieren, wenn er Miteigentümer dieser Jobvariablen ist.
Jobvariablen werden bei Versions-Backup nicht mitgesichert.
JV-NAMES = *NONE
Es werden keine Jobvariablen restauriert.
JV-NAMES = *OWN
Es werden alle Jobvariablen der eigenen Benutzerkennung von allen Pubsets restauriert. Die Auswahl erfolgt aus dem Dateiverzeichnis.
JV-NAMES = *SELECTED
Die Pfadnamen der Jobvariablen, die restauriert werden sollen, werden einer Liste entnommen. Diese Liste wurde im selben HSMS-Lauf mit der HSMS-Anweisung SELECT-JV-NAMES erstellt.
JV-NAMES = *ALL
Es werden alle Jobvariablen auf allen Pubsets restauriert. Die Auswahl erfolgt aus dem Dateiverzeichnis.
JV-NAMES = *FROM-FILE(...)
Die Pfadnamen der Jobvariablen, die restauriert 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. Es dürfen nur Großbuchstaben verwendet werden.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
JV-NAMES = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Jobvariablen, die restauriert 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.
JV-NAMES = list-poss(20): <filename 1..80 without-gen-vers-with-wild> / <partial-filename 2..79 with-wild>
Die Pfadnamen der Jobvariablen, die restauriert 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. Die Wildcard-Syntax wird anhand der Jobvariablennamen im Archivverzeichnis aufgelöst.
EXCEPT-JV-NAMES =
Sie können Jobvariablen angeben, die nicht restauriert werden sollen.
EXCEPT-JV-NAMES = *NONE
Es werden alle Jobvariablen restauriert, die beim Operanden JV-NAMES angegeben sind.
EXCEPT-JV-NAMES = *FROM-FILE(...)
Die Pfadnamen der Jobvariablen, die nicht restauriert 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. Es dürfen nur Großbuchstaben verwendet werden.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Pfadname der Datei.
EXCEPT-JV-NAMES = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Jobvariablen, die nicht restauriert 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-NAMES = list-poss(20): <filename 1..80 without-vers-with-wild> / <partial-filename 2..79 with-wild>
Die Pfadnamen der Jobvariablen, die nicht restauriert 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. Die Wildcard-Syntax wird anhand der Jobvariablennamen im Archivverzeichnis aufgelöst.
NEW-JV-NAMES = *SAME / *BY-RULE(...)
Sie können die Jobvariablen vor der Restaurierung umbenennen.
Die Jobvariablen können vor dem Importieren mit NEW-JV-NAMES=*BY-RULE(...) umbenannt werden. Die Möglichkeiten und Unteroperanden sind dieselben wie bei Dateien (siehe NEW-FILE-NAMES=*BY-RULE(...)).
RELEASE-UNUSED-SPACE = *NO / *YES
Bestimmt, ob beim Restaurieren der Dateien der ungenutzte Speicherplatz (Differenz zwischen Last-Page-Pointer und Dateigröße) freigegeben wird oder nicht.
FILE-CONVERSION =
Steuert, ob Dateien, die ein anderes PAM-Schlüssel-Format haben als der Ausgabedatenträger, beim Restaurieren konvertiert werden. Für Jobvariablen wird dieser Operand ignoriert. Die Angabe von *STD oder *CONV-FORMAT führt zum internen Aufruf von PAMINT.
Bei partiell gesicherten Dateien ist nur die Angabe *CONV-FORMAT möglich.
Wenn eine zu restaurierende Datei, die konvertiert wird, bereits existiert, wird sie in jedem Fall reorganisiert und RELEASE-UNUSED-SPACE wird ignoriert.
FILE-CONVERSION = *STD
PAMINT konvertiert Dateien mit PAM-Schlüssel bei einem Restore-Lauf auf eine NK-Platte nach folgenden Regeln:
K-ISAM Dateien in NK-ISAM-Dateien(BLOCK-CONTROL-INFO=*WITHIN-DATA-BLOCK)
K-SAM Dateien in NK-SAM-Dateien(BLOCK-CONTROL-INFO=*WITHIN-DATA-BLOCK)
K-UPAM-Dateien in NK-UPAM-Dateien(BLOCK-CONTROL-INFO=*NO)PAM-Dateien mit bekanntem Aufbau (Phasen, Bibliotheken) werden entsprechend umgesetzt. Bei konvertierbaren PAM-Dateien mit unbekanntem Aufbau geht die PAM-Schlüssel-Information verloren. Eine Meldung zeigt an, wenn der PAM-Schlüssel Informationen enthielt.
FILE-CONVERSION = *NO
Dateien mit PAM-Schlüssel werden bei einem Restore-Lauf auf eine NK-Platte nicht konvertiert und damit nicht restauriert.
FILE-CONVERSION = *CONV-FORMAT
PAMINT setzt Dateien mit PAM-Schlüssel bei einem Restore-Lauf auf eine NK-Platte ins „CONV-Format“ um. Die restaurierte Datei enthält alle PAM-Schlüssel am Dateiende in separaten Blöcken.
DATE-AND-PROTECTION =
Der Operand wird nur beim Restaurieren aus Langzeitarchiven ausgewertet. Beim Restaurieren aus Backup-Archiven werden die Datums- und Schutzattribute stets aus dem Sicherungsbestand übernommen.
Bestimmt, wie für Dateien und Jobvariablen, die bei der Sicherung durch GUARDS oder BASIC-ACL geschützt waren und bzgl. der Katalog- oder Benutzerkennung umbenannt werden sollen, die Datums- und Schutzattribute gesetzt werden.
DATE-AND-PROTECTION = *STD-ATTRIBUTES
Die Datums- und Schutzattribute werden nach dem Standardverfahren gesetzt. Dies bedeutet:
Datums- oder Schutzattribut | Datei wird auf Platte überschrieben | |
YES | NO | |
Wert der Kennwortattribute | wie die der Sicherungsdatei | wie die der Sicherungsdatei |
Wert von USER-ACCESS | wie der von Platte | *OWNER-ONLY |
Wert von ACCESS | wie der von Platte | *WRITE |
Wert von BASIC-ACL, GUARDS | wie der von Platte | *OFF |
Wert für Erstellungs-, Verfalls- und letztes Zugriffsdatum | aktuelles Datum | aktuelles Datum |
DATE-AND-PROTECTION = *ORIGINAL-ATTRIBUTES
Die Datums- und Schutzattribute werden aus dem Sicherungsbestand übernommen.
REPLACE-FILES-AND-JV = *NO / *YES(...)
Bestimmt, ob bereits existierende Dateien und Jobvariablen beim Restaurieren überschrieben werden. Bei REPLACE=*NO werden die Namen der Dateien und Jobvariablen, die nicht überschrieben werden, nur im vollständigen Report (REPORT=*FULL) aufgelistet.
REPLACE-FILES-AND-JV = *YES(...)
Existierende Dateien und Jobvariablen werden überschrieben. Sie können festlegen, inwieweit die Schutzattribute der Dateien beachtet werden müssen:
PROTECTION-RESPECTED = *ALL
Es werden nur die Dateien und Jobvariablen überschrieben, für die kein Kennwortschutz vereinbart wurde, für die Schreibzugriff erlaubt ist und deren Schutzfrist abgelaufen ist.
PROTECTION-RESPECTED = *PASSWORDS
Es werden nur die Dateien und Jobvariablen überschrieben, für die kein Kennwortschutz vereinbart wurde.
PROTECTION-RESPECTED = *NONE
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Alle Dateien und Jobvariablen werden ohne Rücksicht auf ihre Schutzattribute überschrieben.
REORGANIZE-SPACE = *YES / *NO
Bestimmt, ob die Dateien vor dem Zurückschreiben gelöscht werden (was zum Reorganisieren der Datei führt) oder ob die Datei mit denselben Extents auf der Platte bestehen bleibt. Der Operand wird nur bei bestehenden Dateien ausgewertet.
PASSWORDS = *NONE / *SECRET-PROMPT / list-poss(63): <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647>
Sind zu restaurierende Dateien oder Jobvariablen durch ein Kennwort geschützt oder wurde die Sicherungsdatei mit einem Kennwort versehen, dann sind die Kennwörter hier anzugeben. Ein HSMS-Verwalter braucht kein Kennwort anzugeben.
Wenn eine Directory-Datei benutzt wird und diese mit Kennwörtern geschützt ist, müssen alle Benutzer das Lese- und Schreibkennwort angeben.
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.
ARCHIVE-NAME =
Bestimmt in der angegebenen Umgebung den Namen des Archivs, aus dem die Dateien und Jobvariablen restauriert werden sollen. Wenn beim Restore ein Schattenarchiv verwendet werden soll, muss sein Archivname explizit angegeben werden.
Name des Archivs, aus dem die Dateien und Jobvariablen restauriert werden sollen. Wenn ein Standard-Systemarchiv angegeben wird, muss dieses Systemarchiv eingerichtet und (bei Restaurieren in mehr als ein Pubset) eindeutig zuzuordnen sein.
Wenn das Archivverzeichnis kennwortgeschützt ist, müssen Sie das Kennwort für das Archivverzeichnis vorher mit dem ADD-PASSWORD-Kommando eingeben. Das trifft auch für HSMS-Verwalter zu.
Damit der nicht-privilegierte Benutzer das Archiv eines anderen Benutzers verwenden kann, muss für dieses Archiv eine Leseberechtigung bestehen (USER-ACCESS=*ALL-USERS und ACCESS=*READ) oder Miteigentümerschaft für das Archivverzeichnis.
ARCHIVE-NAME = *SYSBACKUP
Die Dateien werden aus der angegebenen Umgebung aus dem zugeordneten Standard-Systemarchiv für die Datensicherung geholt.
ARCHIVE-NAME = *SYSARCHIVE
Die Dateien werden aus dem zugeordneten Standard-Systemarchiv für die Langzeitarchivierung geholt.
ARCHIVE-NAME = *SYSMIGRATE
Die Dateien werden aus der angegebenen Umgebung aus dem zugeordneten Standard-Systemarchiv für die Migration geholt.
ARCHIVE-NAME = *SYSVERSION
Die Dateien werden aus dem Systemarchiv für Versions-Backup restauriert, das dem im Operanden FILE-NAMES angegebenen Pubset zugeordnet ist. Das bedeutet, dass die Angabe von Dateien von verschiedenen Pubsets abgelehnt wird.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
Die Dateien werden aus der angegebenen Umgebung aus dem angegebenen Archiv geholt.
SELECT-SAVE-VERSIONS =
Es werden die Sicherungsversionen festgelegt, die zum Restore herangezogen werden.
Die jeweils letzte Version jeder Datei, die mit FILE-NAMES angegeben wurde, wird aus den angegebenen Sicherungsversionen restauriert, wenn Sie nicht durch DIALOG-FILE-SELECT einzelne Versionen explizit ausgewählt haben.
Mit der expliziten Angabe von FILE-NAMES=*ALL(*OWN) zusammen mit dem Standardwert von SELECT-SAVE-VERSIONS=*STD oder SELECT-SAVE-VERSIONS=*ALL werden von allen gesicherten Dateien (des Aufrufers) die jeweils jüngsten Dateiversionen restauriert. Die Angabe von *STD und *ALL sollte daher nur nach reiflicher Überlegung erfolgen (z.B. in Verbindung mit der expliziten Angabe von Dateinamen), um nicht auf eine unnötig große Anzahl von Sicherungsversionen und Datenträgern zuzugreifen.
SELECT-SAVE-VERSIONS=*STD
Die Wirkung dieser Angabe hängt von dem Archivtyp ab.
Für Langzeit-, Backup-, ihre Schattenarchive sowie Migrationsarchive ist die Wirkung dieselbe wie bei *ALL.
Für Versions-Backup-Archive hat der Operand dieselbe Bedeutung, wie die Angabe SAVE-VERSIONS=*BY-ATTR(SAVE-VERSION-NAME=*ANY, SAVE-VERSION-DATE=*BY-ORIGINAL-DATE(CREATED-BEFORE=*LATEST-DATE ,CREATED-AFTER=*EARLIEST-DATE). D.h. im Falle von Versions-Backup wird die jüngste Dateiversion restauriert.
Nach einer Reorganisation eines Versions-Backup-Archivs kann es vorkommen, dass ältere Versionen einer Datei in Sicherungsversionen mit neuerem Zeitstempel enthalten sind. Die Auswahl der zu restaurierenden Dateiversionen erfolgt daher nicht nach dem Zeitstempel der SVIDs sondern nach dem Zeitstempel der ursprünglichen Sicherung (*BY-ORIGINAL-DATE).
SELECT-SAVE-VERSIONS = *ALL
Diese Option ist nur für Backup- und Langzeitarchive, ihre Schattenarchive sowie Migrationsarchive relevant.
Alle Sicherungsversionen werden für den Restore herangezogen. Die angegebenen Dateien und Jobvariablen werden in jedem Fall aus der jeweils letzten Sicherungsversion geholt, in die sie gesichert wurden.
Für Versions-Backup-Archive wird diese Option abgelehnt.
SELECT-SAVE-VERSIONS = *LATEST(...)
Diese Option ist nur für Backup- und Langzeitarchive, ihre Schattenarchive sowie Migrationsarchive relevant.
Nur die zuletzt erstellte Sicherungsversion wird für den Restore herangezogen.
Beim Restaurieren aus einem Backup-Archiv bedeutet dies, dass von den angegebenen Dateien nur die restauriert werden, die bei der letzten Sicherung gesichert oder als Cataloged-Not-Saved (CNS) vermerkt wurden.
Dieser Operand steht bei Versions-Backup-Archiven nicht zur Verfügung.
DAY-INTERVAL = *NO
Nur die zuletzt erstellte Sicherungsversion wird für den Restore berücksichtigt.
DAY-INTERVAL = *YES
Dieser Operand ist nur für gesicherte Dateien verfügbar.
Wenn mehrere Sicherungsversionen am selben Tag erstellt wurden, kann der Begriff „letzte Sicherungsversion“ durch die Angabe von DAY-INTERVAL=*YES auf eine Reihe von Sicherungsversionen ausgedehnt werden, die alle am selben Tag erstellt wurden.
In diesem Fall werden die zuletzt erstellte Sicherungsversion sowie alle Sicherungsversionen, die am selben Tag wie die letzte Sicherungsversion erstellt wurden, für den Restore berücksichtigt. Dies ist aber nicht möglich, wenn die Sicherungsversion mit der HSMS-Anweisung ARCHIVE-FILES erstellt wurde.
CREATED-AFTER = *EARLIEST-DATE
Dateien, die bei der letzten Sicherung als Cataloged-Not-Saved (CNS) vermerkt wurden, werden von der zuletzt erstellten Sicherungsversion restauriert – unabhängig vom Erstellungsdatum der Sicherungsversion.
CREATED-AFTER = <date with-compl>
Dateien, die bei der letzten Sicherung als Cataloged-Not-Saved (CNS) vermerkt wurden, werden nur dann restauriert, wenn sie in einer Sicherungsversion gesichert wurden, die an oder nach dem angegebenen Datum erstellt wurde.
CREATED-AFTER = <integer -99999..0 days >
Die Auswahl wird auf die Sicherungsversionen eingeschränkt, die an oder nach dem angegebenen relativen Datum erstellt wurden.
SELECT-SAVE-VERSIONS = *BY-ATTRIBUTES(...)
Sie können die Sicherungsversion, die zum Restore herangezogen wird, über ihre Attribute auswählen.
SAVE-VERSION-NAME = *ANY / <name 1..8>
Sie können die Sicherungsversion, die zum Restore herangezogen werden soll, über den Namen auswählen, der bei der Erstellung vergeben wurde.
Nur ein HSMS-Verwalter kann Sicherungsversionen auswählen, die er nicht selbst erstellt hat.
Standardmäßig werden die Sicherungsversionen unabhängig von ihrem Namen zum Restore herangezogen.
Beim Restaurieren aus Versions-Backup-Archiven ist nur der Wert *ANY relevant.
SAVE-VERSION-DATE =
Sie können die Sicherungsversion, die zum Restore herangezogen werden soll, durch das Datum ihrer Erstellung auswählen. Wenn Sie eine Sicherungsversion über ihren Namen ausgewählt haben, werden durch das Erstellungsdatum nur Sicherungsversionen mit diesem Namen ausgewählt.
SAVE-VERSION-DATE = *LATEST
Diese Option ist nur für Backup- und Langzeitarchive, ihre Schattenarchive sowie Migrationsarchive relevant.
Nur die zuletzt erstellte Sicherungsversion im Archiv wird für den Restore herangezogen. Die Angabe entspricht bei SAVE-VERSION-NAME=*ANY der Angabe SELECT-SAVE-VERSIONS=*LATEST.
Für Versions-Backup-Archive wird dieser Operand abgelehnt.
SAVE-VERSION-DATE = <date with-compl>(...)
Diese Option ist nur für Backup- und Langzeitarchive, ihre Schattenarchive sowie Migrationsarchive relevant.
Die letzte Sicherungsversion, die an oder vor dem angegebenen Datum erstellt wurde, wird für den Restore herangezogen.
Für Versions-Backup-Archive wird dieser Operand abgelehnt.
TIME = 23:59:59 / <time>
Die letzte Sicherungsversion, die an oder vor dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurde, wird für den Restore herangezogen.
SAVE-VERSION-DATE = *INTERVAL(...)
Diese Option ist nur für Backup- und Langzeitarchive, ihre Schattenarchive sowie Migrationsarchive relevant.
Die Sicherungsversionen werden durch ein Zeitintervall ausgewählt.
Das Intervall umfasst alle Sicherungsversionen, die zwischen CREATED-AFTER und CREATED-BEFORE erstellt wurden.
Standardmäßig werden alle Sicherungsversionen von der zuerst erstellten *EARLIEST-DATE) bis zur zuletzt erstellten (*LATEST-DATE) ausgewählt. Die Angabe entspricht bei SAVE-VERSION-NAME=*ANY der Angabe SELECT-SAVE-VERSIONS=*ALL und sollte wie diese nur nach sorgfältiger Überlegung angewendet werden.
Für Versions-Backup-Archive wird dieser Operand abgelehnt.
CREATED-BEFORE = *LATEST-DATE
Die Sicherungsversionen werden unabhängig davon ausgewählt, ob sie vor einem bestimmten Termin erstellt wurden. Durch ein zusätzliches Zeitfeld kann die Auswahl präzisiert werden.
CREATED-BEFORE = <date with-compl>(...) / <integer -99999..0 days >(...)
Es werden nur die Sicherungsdateien ausgewählt, die vor dem angegebenen Datum erstellt wurden. Das Datum wird entweder absolut oder relativ zum Tagesdatum angegeben. Durch ein zusätzliches Zeitfeld kann die Auswahl präzisiert werden.
TIME = 23:59:59 / <time>
Zeit im Format hh:mm:ss
CREATED-AFTER = *EARLIEST-DATE
Die Sicherungsversionen werden unabhängig davon ausgewählt, ob sie nach einem bestimmten Termin erstellt wurden.
CREATED-AFTER = <date with-compl>
Es werden nur die Sicherungsversionen ausgewählt, die an oder nach dem angegebenen Datum erstellt wurden.
CREATED-AFTER = <integer -99999..0 days >
Es werden nur die Sicherungsversionen ausgewählt, die an oder nach dem angegebenen relativen Datum erstellt wurden.
SAVE-VERSION-DATE = *BY-ORIGINAL-DATE(...)
Dieser Operand ist nur für Sicherungsversionen von Migrations-, Langzeit- oder Versions-Backup-Archiven relevant.
Die Wirkung dieser Angabe hängt von dem Archivtyp ab:
- Migrations- oder Langzeitarchive
Sie können die Sicherungsversion eines Migrations- oder Langzeitarchivs über ihr Ursprungsdatum auswählen (siehe „Sicherungsdateien kopieren“ im Handbuch „HSMS Bd. 1“ [1]). Es wird die Sicherungsversion mit dem höchsten Ursprungsdatum in dem angegebenen Zeitintervall ermittelt. Besitzen mehrere Sicherungsversionen dasselbe Ursprungsdatum, so wird die zuletzt erstellte Sicherungsversion ausgewählt. - Versions-Backup-Archive
Nach einer Reorganisation eines Versions-Backup-Archivs kann es vorkommen, dass ältere Versionen einer Datei in Sicherungsversionen mit neuerem Zeitstempel enthalten sind. Die Auswahl der zu restaurierenden Dateiversionen erfolgt daher nicht nach dem Zeitstempel der SVIDs sondern nach dem Zeitstempel der ursprünglichen Sicherung (*BY-ORIGINAL-DATE).
CREATED-BEFORE = *LATEST-DATE
Das Ursprungsdatum der zur Auswahl betrachteten Sicherungsversionen ist nach oben nicht beschränkt.
CREATED-BEFORE = <date with-compl>(...) / <integer -99999..0 days > (...) Das Ursprungsdatum der zur Auswahl betrachteten Sicherungsversionen ist nach oben beschränkt durch das angegebene Datum. Das Datum wird entweder absolut oder relativ zum Tagesdatum angegeben. Eine zusätzliche Zeitangabe präzisiert die Auswahl:
TIME = 23:59:59 / <time>
Zeit im Format hh:mm:ss
CREATED-AFTER = *EARLIEST-DATE
Das Ursprungsdatum der zur Auswahl betrachteten Sicherungsversionen ist nach unten nicht beschränkt.
CREATED-AFTER = <date with-compl> / <integer -99999..0 days >
Das Ursprungsdatum der zur Auswahl betrachteten Sicherungsversionen ist nach unten beschränkt durch das absolut oder relativ angegebene Tagesdatum.
CREATED-AFTER = *SAME-AS-BEFORE
Es wird nur die Sicherungsversion ausgewählt, deren Ursprungsdatum genau mit dem im Operanden CREATED-BEFORE angegebenen Datum übereinstimmt.
DEVICE-TYPE = *STD / <device>
Gerätetyp des Datenträgers, auf dem die Sicherungsversion steht. Die Angabe ist nur nötig, wenn die Sicherungsversion in einer ARCHIVE-Version < V2.6B erstellt wurde. In höheren ARCHIVE-Versionen wird der Gerätetyp, der zur Sicherung verwendet wurde, in der Directory-Datei vermerkt und eine davon abweichende Angabe ignoriert.
Es werden nur Gerätetypen akzeptiert, die im System bekannt sind. Im Dialog werden mit DEVICE-TYPE=? die möglichen Gerätetypen angezeigt.
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
Anmerkung
Wenn Bandvolumes von einem alten auf einen neuen Gerätetyp mit gleicher VSN „offline“ umkopiert wurden ohne das Directory anzupassen, kann durch einen optionalen Rep erreicht werden, dass der explizit angegebene Gerätetyp Vorrang erhält vor dem in der Directory-Datei vermerkten Gerätetyp und somit auch ein von der Directory-Datei abweichender Gerätetyp akzeptiert wird.
DIALOG-FILE-SELECT =
Bestimmt, ob die Dateimenge, die durch FILE-NAMES und weitere Operanden ausgewählt wurde, im Dialog noch eingeschränkt werden soll.
Damit kann der Benutzer prüfen, ob die von ihm angegebenen Dateien tatsächlich in den von ihm angegebenen Sicherungsversionen enthalten sind, bevor der Auftrag asynchron verarbeitet wird und eventuell Fehler auftreten.
Der Operand wird nur im Dialog ausgewertet; für Stapelaufträge wird er ignoriert.
DIALOG-FILE-SELECT = *NO
Die ausgewählte Dateimenge wird nicht eingeschränkt.
DIALOG-FILE-SELECT = *YES(...)
Die ausgewählte Dateimenge wird in einer Bildschirmmaske ausgegeben. Aus dieser Dateimenge können Sie durch Markieren einzelne Dateien entweder bestätigen oder ausschließen.
Details zum Inhalt der Bildschirmmaske finden Sie im Abschnitt „Dialogauswahl beim Restaurieren von Dateien“, für die Restaurierung von Langzeit-oder Migrationsarchiven im Abschnitt "Dialogauswahl beim Restaurieren von Dateien aus einem Langzeit- oder Migrationsarchiv für die Auswahl einer Sicherungsversion anhand der ursprünglichen Daten".
SHOW-FILE-VERSIONS =
Regelt, in welchem Umfang verschiedene Sicherungsversionen einer Datei auf dem Bildschirm ausgegeben werden.
Hinweis: Bei Versions-Backup-Archiven ergibt SHOW-FILE-VERSIONS = *DIFFERENT und SHOW-FILE-VERSIONS = *ALL dasselbe Ergebnis, da im Versions-Backup-Archiv von einer Datei immer nur eine Version gesichert bzw. aufbewahrt wird.
SHOW-FILE-VERSIONS = *LATEST
Die Dateien werden nur aus den jeweils zuletzt erstellten Sicherungsversionen ausgegeben, die sie enthalten.
Hinweis: Im Falle eines Versions-Backup-Archivs bedeutet dies die neueste Version gemäß ihrer ursprünglichen Sicherungsversion, also tatsächlich die neueste Version der Datei im ausgewählten Bereich der Sicherungsversionen.
SHOW-FILE-VERSIONS = *DIFFERENT
Es werden nur die Sicherungsversionen einer Datei ausgegeben, bei denen sich die Datei seit der vorhergehenden Sicherung geändert hat, d.h. eine andere Versionsnummer oder einen anderen Internen Dateinamen (Coded-File-ID, CFID) hat.
SHOW-FILE-VERSIONS = *ALL
Alle Sicherungsversionen einer Datei werden ausgegeben.
DIALOG-JV-SELECT =
Bestimmt, ob die Jobvariablenmenge, die durch JV-NAMES und weitere Operanden für den Restore ausgewählt wurde, im Dialog noch eingeschränkt werden soll.
Damit kann der Benutzer prüfen, ob die von ihm angegebenen Jobvariablen tatsächlich in den von ihm angegebenen Sicherungsversionen enthalten sind, bevor der Auftrag asynchron verarbeitet wird und eventuell Fehler auftreten.
Der Operand wird nur im Dialog ausgewertet. Für Stapelaufträge wird er ignoriert.
DIALOG-JV-SELECT = *NO
Die ausgewählte Menge von Jobvariablen wird nicht eingeschränkt.
DIALOG-JV-SELECT = *YES(...)
Die ausgewählte Menge von Jobvariablen wird in einer Bildschirmmaske ausgegeben. Sie können aus dieser Jobvariablenmenge durch Markieren einzelne Jobvariablen entweder bestätigen oder ausschließen.
Details zum Inhalt der Bildschirmmaske finden Sie im Abschnitt „Dialogauswahl beim Restaurieren von Jobvariablen“ , für die Restaurierung aus Langzeit-oder Migrationsarchiven im Abschnitt "Dialogauswahl beim Restaurieren von JVs aus einem Langzeitarchiv für die Auswahl einer Sicherungsversion anhand der ursprünglichen Daten" .
SHOW-JV-VERSIONS =
Regelt, in welchem Umfang verschiedene Sicherungsversionen einer Jobvariable auf dem Bildschirm ausgegeben werden.
SHOW-JV-VERSIONS = *LATEST
Die Jobvariablen werden nur aus den jeweils zuletzt erstellten Sicherungsversionen ausgegeben, die sie enthalten.
SHOW-JV-VERSIONS = *ALL
Alle Sicherungsversionen einer Jobvariable werden ausgegeben.
OPERATION-CONTROL =
Sie können Parameter für den Ablauf dieses Restore-Laufs 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 Restore-Laufs ä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 „RSF#“ und der TSN des aufrufenden Benutzerauftrags yyyy in der Form: RSF#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.
PARALLEL-RUNS = *STD / <integer 1..16>
Dieser Operand ist nur beim Arbeiten auf der Speicherebene S2 von Bedeutung. Er legt die Anzahl der gleichzeitig ablaufenden Sicherungstasks (ARCHIVE-Subtasks) fest.
Für jede Task müssen zwei Bandgeräte zur Verfügung stehen.
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
Nähere Informationen zur parallelen Verarbeitung finden Sie im Handbuch „HSMS Bd. 1“ [1].
WRITE-CHECKPOINTS = *STD / *YES / *NO
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Bestimmt, ob während der Verarbeitung Wiederaufsetzpunkte in die ARCHIVE-Checkpointdatei geschrieben werden, die bei einem Abbruch (Status INTERRUPTED) einen späteren Wiederanlauf ermöglichen.
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
OPERATOR-INTERACTION = *STD / *NOT-ALLOWED / *ALLOWED
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
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).
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
TAPE-CONTROL =
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Sie können Parameter für das Lesen von Magnetband festlegen.
TAPE-CONTROL = *STD
Es gelten jeweils die Voreinstellungen aus der Definition des Archivs, aus dem restauriert wird.
TAPE-CONTROL = *PARAMETERS(...)
Sie können folgenden Operanden für das Lesen von Magnetband ändern:
UNLOAD-TAPE = *STD / *YES / *NO
Bestimmt, ob ein Magnetband nach dem Ende der Verarbeitung entladen wird oder nicht.
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
Möglicherweise ignoriert HSMS den Wert dieses Operanden, um eine unrationelle Bandbearbeitung zu vermeiden, wie z.B. mehrfaches Entladen beim Zurückspulen des Bandes.
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 Restore-Auftrag ausgegeben werden soll.
REPORT = *SUMMARY
Ausgegeben wird eine Zusammenfassung des Ergebnisses des Restore-Auftrags mit eventuellen Fehlermeldungen.
REPORT = *RESTORED-FILES
Ausgegeben wird ein Report mit einer Liste der tatsächlich restaurierten Dateien.
REPORT = *FULL
Ausgegeben wird ein Report mit einer Liste auch der Dateien, die restauriert werden sollten, aber aus bestimmten Gründen nicht restauriert wurden.
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 Restore-Auftrags 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 Restore-Auftrags 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 Restore-Auftrags 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 Restore-Auftrags 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.
Dialogauswahl beim Restaurieren von Dateien
//RESTORE-FILES ...,DIALOG-FILE-SELECT=*YES,...
RESTORE-FILES : DIALOG-FILE-SELECT SHOW-FILE-VERSIONS = @@@@@@@@@@
#FILES = @@@@@@@@@@ ARCHIVE-NAME = @@@@@@@@@@@@@@@@@@@@@@
ENVIRONMENT = @@@@@@@@ SV-DATE = @@@@@@@@ @@@@@@@@ @@@@@@@@
SV-NAME = @@@@@@@@ @@@@@@@@@
--------------------------------------------------------------------------------
M FILE-NAME VERS S-DATE S-TIME S
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
--------------------------------------------------------------------------------
NEXT-PAGE : (+,-,++,--, E, 'STRING') MARK : (A: ALL, N: NONE)
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Legende:
Spalte | Werte | Bedeutung |
M | Markierungsspalte (Zeichen = Datei wird ausgewählt, Leerzeichen = Datei wird nicht ausgewählt) | |
FILE-NAME | Pfadname der Datei | |
VERS | Version der Datei zum Zeitpunkt der Sicherung | |
S-DATE | Datum der Sicherung der Datei | |
S-TIME | Tageszeit der Sicherung der Datei in der Form | |
S | Anzeige, ob es eine namensgleiche Datei im System gibt: | |
Y |
| |
N |
|
Anmerkung
Bei Dateiständen, die in einer Differenzsicherung als CNS gesichert wurden, aber nicht mehr restauriert werden können, weil die Vollsicherung dazu fehlt, wird anstelle der Werte für S-Date und S-Time die Zeichenkette „RESTORE FAILS“ ausgegeben.
Dialogauswahl beim Restaurieren von Jobvariablen
//RESTORE-FILES ...,DIALOG-JV-SELECT=*YES,...
RESTORE-FILES : DIALOG-JV-SELECT SHOW-JV-VERSIONS = @@@@@@@@@@
#JVS = @@@@@@@@@@ ARCHIVE-NAME = @@@@@@@@@@@@@@@@@@@@@@
ENVIRONMENT = @@@@@@@@ SV-DATE = @@@@@@@@ @@@@@@@@ @@@@@@@@
SV-NAME = @@@@@@@@ @@@@@@@@@
--------------------------------------------------------------------------------
M JV-NAME VERS S-DATE S-TIME S
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@ @@@@@@@@ @@@@@@ @
--------------------------------------------------------------------------------
NEXT-PAGE : (+,-,++,--, E, 'STRING') MARK : (A: ALL, N: NONE)
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Legende:
Spalte | Werte | Bedeutung |
M | Markierungsspalte (Zeichen = Jobvariable wird ausgewählt, Leerzeichen = Jobvariable wird nicht ausgewählt) | |
JV-NAME | Pfadname der Jobvariablen | |
VERS | Version der Jobvariablen zum Zeitpunkt der Sicherung | |
S-DATE | Datum der letzten Sicherung der Jobvariablen | |
S-TIME | Tageszeit der Sicherung der Jobvariablen in der Form | |
S | Anzeige, ob es eine namensgleiche Jobvariable im System gibt: | |
Y |
| |
N |
|
Dialogauswahl beim Restaurieren aus einem Versions-Backup-Archiv
//RESTORE-FILES ...,DIALOG-FILE-SELECT=*YES,...
|
Legende:
Spalte | Werte | Bedeutung |
|---|---|---|
M | Markierungsspalte (Zeichen = Datei wird ausgewählt, Leerzeichen = Datei wird nicht ausgewählt | |
FILE‑NAME | Pfadname der Datei | |
VER | Version der Datei zum Zeitpunkt der Sicherung | |
O‑DATE | Datum der Original-Sicherung der Dateiversion in das Versions-Backup-Archiv | |
O‑TIME | Zeit der Original-Sicherung der Dateiversion im Format hhmmss | |
S | Zeigt an, ob eine Datei dieses Namens bereits im System existiert: | |
Y |
| |
N |
| |
E |
| |
D | Zeigt an, ob die Dateiversion obsolet ist oder ob die Datei zum Löschen vorgemerkt wurde. | |
O |
| |
D |
| |
blank |
|
Hinweis:
Ist eine Dateiversion sowohl obsolet als auch zum Löschen vorgemerkt, wird in Spalte D der Wert "D" ausgegeben.
Das Auswahlverfahren ist im Handbuch „HSMS Bd. 1“ [1] beschrieben.
Dialogauswahl beim Restaurieren von Dateien aus einem Langzeit- oder Migrationsarchiv für die Auswahl einer Sicherungsversion anhand des ursprünglichen Datums
//RESTORE-FILES ...,SAVE-VERSION-DATE=*BY-ORIGINAL-DATE, ...,DIALOG-FILE-SELECT=*YES, ...
|
Legende:
| Spalte | Werte | Bedeutung |
|---|---|---|
M | Markierungsspalte (Zeichen = Datei wird ausgewählt, Leerzeichen = Datei wird nicht ausgewählt) | |
FILE-NAME | Pfadname der Datei | |
VERS | Version der Datei zum Zeitpunkt der Sicherung | |
O-DATE | Datum der Original-Sicherung der Dateiversion in das Langzeit- oder Migrationsarchiv | |
O-TIME | Zeit der Original-Sicherung der Dateiversion im Format hhmmss | |
S | Zeigt an, ob eine Datei dieses Namens bereits im System existiert: | |
Y |
| |
N |
|
Dialogauswahl beim Restaurieren von JVs aus einem Langzeitarchiv für die Auswahl einer Sicherungsversion anhand des ursprünglichen Datums
//RESTORE-FILES ...,SAVE-VERSION-DATE=*BY-ORIGINAL-DATE, ...,DIALOG-JV-SELECT=*YES, ...
|
Legende:
| Spalte | Werte | Bedeutung |
|---|---|---|
M | Markierungsspalte (Zeichen = Job Variable wird ausgewählt, Leerzeichen = Job Variable wird nicht ausgewählt) | |
JV-NAME | Pfadname der Job Variablen | |
VERS | Version der Job Variablen zum Zeitpunkt der Sicherung | |
O-DATE | Datum der Original-Sicherung der Job Variablen in das Langzeitarchiv | |
O-TIME | Zeit der Original-Sicherung der Job Variablen im Format hhmmss | |
S | Zeigt an, ob eine Job Variable dieses Namens bereits im System existiert: | |
Y |
| |
N |
|
Beispiele:
Ein nicht-privilegierter Benutzer restauriert eine versehentlich gelöschte Datei mit HSMS-Standardwerten; seine TSN sei 2345
//RESTORE-FILES FILE-NAMES=file.1
Die Datei FILE.1 seiner Benutzerkennung und Standard-Katalogkennung wird aus dem Standard-Systemarchiv für Datensicherung (*SYSBACKUP) geholt.
Die Datei FILE.1 wird unter demselben Namen auf den Datenträger (Public oder Privatplatte), von dem sie gesichert wurde, wieder eingespielt.
Die Datei wird in allen Sicherungsversionen gesucht, aber aus der letzten restauriert, in der sie enthalten ist. Der aktuelle Stand wird also eingespielt.
Der Auftrag erhält den Namen RSF#2345.
Der Auftrag wird asynchron bearbeitet.
Je nach globalem HSMS-Parameter OUTPUT wird eine Zusammenfassung gedruckt oder als Email-Anhang verschickt.
Ein HSMS-Verwalter restauriert eine nach einer früheren Bearbeitung archivierte Datei aus dem System-Langzeitarchiv mit einem Präfix auf eine andere Benutzerkennung; seine TSN sei 1EWW
//RESTORE-FILES FILE-NAMES=$test1.file.2, - // NEW-FILE-NAMES=*BY-RULE(NEW-USER-ID=test2,PREFIX=arch), - // ARCHIVE-NAME=*SYSARCHIVE
Die Datei $TEST1.FILE.2 wird aus dem Standard-Systemarchiv für Langzeitarchivierung geholt.
Die Datei wird in $TEST2.ARCH.FILE.2 umbenannt und unter der Standard-Katalogkennung von TEST2 eingespielt.
Der Auftrag erhält den Namen RSF#1EWW.
Der Auftrag wird asynchron bearbeitet.
Je nach globalem HSMS-Parameter OUTPUT wird eine Zusammenfassung gedruckt oder als Email-Anhang verschickt.
Beispiele für Versions-Backup
Folgende Sicherungen wurden mit //BACKUP-FILE-VERSIONS erzeugt:
Montag, 2018-05-07 | SVID1 |
Dienstag, 2018-05-08 | SVID2 |
Mittwoch, 2018-05-09 | SVID3 |
Donnerstag, 2018-05-10 | SVID4 |
Folgende Tabelle zeigt die bereits existierenden SVIDs und die Dateiversionen, die darin gesichert wurden:
SVID1 2018-05-07 | SVID2 2018-05-08 | SVID3 2018-05-09 | SVID4 2018-05-10 | |
|---|---|---|---|---|
File.1 | 1 | 2 | 3 | 4 |
File.2 | 1 | 2 | 3 | |
File.3 | 1 | |||
File.4 | 3 | |||
File.5 | 1 |
Die markierten Dateiversionen sind obsolet, weil NUM-OF-BACKUP-VERS=2 für alle Dateien angegeben ist.
Am Freitag, 2018-05-11, werde eine Reorganisation durchgeführt:
//REORGANIZE-VERSION-BACKUP … SAVE-FILE-ID = *ALL
Während der Reorganisation wurden neue SVIDs erzeugt (SVIDs in Klammern sind SVIDs des Originals):
SVID5 | SVID6 | SVID7 | SVID8 | |
|---|---|---|---|---|
File.1 | 3(SVID3) | 4(SVID4) | ||
File.2 | 2(SVID3) | 3(SVID4) | ||
File.3 | 1(SVID1) | |||
File.4 | 3(SVID2) | |||
File.5 | 1(SVID4) |
Am Samstag, 2018-05-12 wurden um 12:13:14 und 15:16:17 zwei Sicherungsläufe durchgeführt (SVIDs in Klammern sind SVIDs des Originals).
SVID5 2018-05-11 | SVID6 2018-05-11 | SVID7 2018-05-11 | SVID8 | SVID9 | SVID10 | |
|---|---|---|---|---|---|---|
File.1 | 3(SVID3) | 4(SVID4) | 5 | |||
File.2 | 2(SVID3) | 3(SVID4) | 4 | |||
File.3 | 1(SVID1) | 2 | ||||
File.4 | 3(SVID2) | 4 | ||||
File.5 | 1(SVID4) | 2 |
Wenn während eines Reorganisationslaufs nicht alle Dateien zum Reorganisieren ausgewählt werden, entsteht die Situation, dass ältere Dateiversionen in neuere SVIDs geschrieben werden. Ältere SVIDs oder Dateiversionen überholen also die neueren.
Die Anweisung unten wurde am 2018-05-13 durchgeführt:
//REORGANIZE-VERSION-BACKUP ... SAVE-FILE-ID = *BY-ATTRIBUTES(CREATED-BEFORE = 2018-05-11)
Während des Reorganisationslaufs wurden neue SVIDs erzeugt:
SVID9 2018-05-11 | SVID10 2018-05-11 | SVID11 2018-05-13 | SVID12 2018-05-13 | SVID13 2018-05-13 | |
|---|---|---|---|---|---|
File.1 | 5 | 4(SVID4) | |||
File.2 | 4 | 3(SVID4) | |||
File.3 | 2 | 1(SVID1) | |||
File.4 | 4 | 5 | 3(SVID2) | ||
File.5 | 2 |
Restaurieren mit Standard-Parametern
//RESTORE-FILES ... SELECT-SAVE-VERSIONS=*STD
Bei Versions-Backup-Archiven wird die jüngste Version restauriert (die restaurierten Versionen sind grün markiert):
Restaurieren mit Auswahl
//RESTORE-FILES ... SELECT-SAVE-VERSIONS=*BY-ATTR(SAVE-VERSION-DATE = *BY-ORIGINAL-DATE=CREATED-BEFORE = 2018-05-16(TIME = 12:00:00), CREATED-AFTER=2018-05-09)
Es werden nur SVIDs des Originals berücksichtigt. Die SVID4 wurde am 2018-05-10 erzeugt und entspricht deswegen den Auswahlkriterien, die am 2018-05-07 erzeugte SVID1 dagegen nicht.
Die markierten Versionen werden restauriert:
SVID9 2018-05-11 | SVID10 2018-05-11 | SVID11 2018-05-13 | SVID12 2018-05-13 | SVID13 2018-05-13 | |
|---|---|---|---|---|---|
File.1 | 5(SVID10) | 4(SVID4) | |||
File.2 | 4(SVID9) | 3(SVID4) | |||
File.3 | 2(SVID10) | 1(SVID1) | |||
File.4 | 4(SVID9) | 5(SVID10) | 3(SVID2) | ||
| File.5 | 2(SVID9) | 1(SVID4) |
//RESTORE-FILES ...SELECT-SAVE-VERSIONS=*BY-ATTR(SAVE-VERSION-DATE = *BY-ORIGINAL-DATE(CREATED-BEFORE = 2018-05-12(TIME = 15:00:00),CREATED-AFTER=2018-05-09)
Es werden nur die Original-SVIDs berücksichtigt (SVID9 entspricht nicht den Auswahlkriterien, da sie keine Original-SVID ist). SVID4 des Originals wurde am 2018-05-10 erzeugt und entspricht deswegen den Auswahlkriterien, die am 2018-05-07 erzeugte Original-SVID1 dagegen nicht:
SVID9 2018-05-12 | SVID10 2018-05-12 | SVID11 2018-05-13 | SVID12 2018-05-13 | SVID13 2018-05-12 | |
|---|---|---|---|---|---|
File.1 | 5(SVID10) | 4(SVID4) | |||
File.2 | 4(SVID9) | 3(SVID4) | |||
File.3 | 2(SVID10) | 1(SVID1) | |||
File.4 | 4(SVID9) | 5(SVID10) | 3(SVID2) | ||
File.5 | 2(SVID9) |
//RESTORE-FILES ... SELECT-SAVE-VERSIONS=*BY-ATTR(SAVE-VERSION-DATE=*BY-ORIGINAL-DATE(CREATED-BEFORE=*LATEST-DATE,CREATED-AFTER=*SAME-AS-BEFORE))
In diesem Beispiel ist die höchste Original-SVID SVID10 (SVID11, SVID12, SVID13 sind keine Original-SVIDs - sie wurden durch Reorganisation erzeugt). Das Restaurieren wird also nur für diejenigen Dateien durchgeführt, die in SVID10 als Original-SVIDs gesichert waren.
Die markierten Versionen werden restauriert.
SVID9 2018-05-11 | SVID10 2018-05-11 | SVID11 2018-05-13 | SVID12 2018-05-13 | SVID13 2018-05-13 | |
|---|---|---|---|---|---|
File.1 | 5(SVID10) | 4(SVID4) | |||
File.2 | 4(SVID9) | 3(SVID4) | |||
File.3 | 2(SVID10) | 1(SVID1) | |||
File.4 | 4(SVID9) | 5(SVID10) | 3(SVID2) | ||
File.5 | 2(SVID9) |
Die Dateien File.2 und File.5 werden nicht restauriert, weil sie nicht innerhalb der höchsten SVID gesichert wurden.
//RESTORE-FILES ... SELECT-SAVE-VERSIONS=*BY-ATTR(SAVE-VERSION-DATE=*BY-ORIGINAL-DATE(CREATED-BEFORE=2018-05-12(TIME=15:16:17),CREATED-AFTER=*SAME-AS-BEFORE))
Die ursprünglichen Sicherungsversionen (SVIDs) werden betrachtet. Die SVID10 wurde ursprünglich am 2018-05-12 um 15:16:17 erstellt und entspricht daher dem Auswahlkriterium. Nur die Dateiversion, die in dieser Sicherungsversion gesichert ist, wird restauriert (markierte Dateiversionen).
SVID9 | SVID10 | SVID11 | SVID12 | SVID13 | |
|---|---|---|---|---|---|
File.1 | 5(SVID10) | 4(SVID4) | |||
File.2 | 4(SVID9) | 3(SVID4) | |||
File.3 | 2(SVID10) | 1(SVID1) | |||
File.4 | 4(SVID9) | 5(SVID10) | 3(SVID2) | ||
File.5 | 2(SVID9) |
File.2 und File.5 werden nicht restauriert, weil sie nicht in der ursprünglichen Sicherungsversion SVID10 gesichert waren.