Diese Anweisung kopiert eine Knoten-Sicherungsdatei und die darin enthaltenen Sicherungsversionen eines BS2000-UFS oder Knoten-S0 Sicherungslaufs eines HSMS-Archivs, entweder innerhalb dieses HSMS-Archivs oder in ein anderes HSMS-Archiv. Nur der Eigentümer eines Archivs und der HSMS-Verwalter dürfen Knoten-Sicherungsdateien kopieren.
Sie können einzelne Knotendateien und Sicherungsversionen auswählen. Sicherungsversionen, deren Freigabedatum erreicht ist, können Sie vom Kopieren ausnehmen.
Beim Kopieren erhalten die neue Sicherungsdatei und die darin verwalteten Sicherungsversionen einen neuen Zeitstempel. Allerdings gibt es folgende Ausnahme: Die Kopie einer Sicherungsversion erhält denselben Zeitstempel wie das Original, wenn von einem Backup-Archiv in ein anderes Backup-Archiv kopiert wird.
Wenn Sicherungsversionen kopiert werden, wird das ursprüngliche Sicherungsdatum im Archivverzeichnis vermerkt. Es kann mit SHOW-ARCHIVE ..., SELECT=*SAVE-VERSIONS, INFORMATION=*USER-INFORMATION ausgegeben werden.
Beim Kopieren ohne Dateiselektion (SELECT-PATHS=*ALL) im selben Archiv oder in das Schattenarchiv werden alle Dateien unabhängig von der Kennung und Privilegierung des Aufrufers kopiert.
Das implizite Löschen von obsoleten Sicherungen kann im Archiv-Attribut eingestellt werden.
Die Anweisung hat ein unterschiedliches Format für nicht-privilegierte Benutzer und HSMS-Verwalter. Privilegierte Operanden bzw. Operandenwerte sind mit *P) markiert.
Format
COPY-NODE-SAVE-FILE | Alias: CNF | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
*P) privilegierter Operand bzw. Operandenwert
SAVE-FILE-ID =
Sicherungsdatei, die kopiert werden soll.
Wenn innerhalb desselben Backup-Archivs kopiert wird, können Sie nur die letzte Sicherungsdatei kopieren (SAVE-FILE-ID=*LATEST). Dadurch wird sichergestellt, dass die Reihenfolge der Sicherungsversionen der zeitlichen Reihenfolge der Sicherungen entspricht.
Wenn zwischen zwei Backup-Archiven kopiert wird, muss die SFID der kopierten Sicherungsdatei größer sein als die SVID der letzten Sicherungsdatei des Zielarchivs.
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-SAVE-VERSIONS =
Sie können aus den Sicherungsversionen, die in der Sicherungsdatei enthalten sind, eine Auswahl treffen.
Wenn innerhalb desselben Backup-Archivs kopiert wird, können Sie nur die letzte Sicherungsversion kopieren (SELECT-SAVE-VERSIONS=*BY-ATTRIBUTES(SAVE-VERSION-DATE=*LATEST-DATE)). Dadurch wird sichergestellt, dass die Reihenfolge der Sicherungsversionen der zeitlichen Reihenfolge der Sicherungen entspricht.
SELECT-SAVE-VERSIONS = *ALL
Alle Sicherungsversionen werden übernommen.
SELECT-SAVE-VERSIONS = *BY-ATTRIBUTES(...)
Auswahlkriterien für die zu übernehmenden Sicherungsversionen:
SAVE-VERSION-NAME =
Namen der Sicherungsversionen, die kopiert werden sollen.
SAVE-VERSION-NAME = *ANY
Die zulässigen Sicherungsversionen sind nicht eingeschränkt.
SAVE-VERSION-NAME = <name 1..8>
Name der Sicherungsversion, die kopiert werden soll.
Ein nicht-privilegierter Benutzer kann damit nur von ihm selbst erstellte Sicherungsversionen auswählen. Der angegebene Name der Sicherungsversion wird für die Bestimmung der zulässigen Sicherungsversionen mit der LOGON-Benutzerkennung oder für Aufträge des HSMS-Verwalters mit SYSHSMS ergänzt.
EXPIRATION-AFTER = *EARLIEST-DATE / <date with compl> / <integer -99999..99999 days>
Es werden nur die Sicherungsversionen übernommen, deren Sperrfrist nach dem angegebenen Datum abläuft. *EARLIEST-DATE bedeutet, dass keine Auswahl über das Expiration-Datum erfolgt.
Dieser Operand ist nur beim Kopieren einer Sicherungsdatei eines Langzeitarchivs sinnvoll, wenn die Sicherungsdatei mehrere Sicherungsversionen („Benutzeraufträge“) mit unterschiedlichen logischen Sperrfristen enthalten kann.
SAVE-VERSION-DATE =
Schränkt das Erstellungsdatum der Sicherungsversionen ein, die für die Kopie zugelassen werden sollen.
SAVE-VERSION-DATE = *INTERVAL(...)
Schränkt die für die Kopie zugelassenen Sicherungsversionen auf ein Zeitintervall ein, in dem ihr Erstellungsdatum liegen muss.
Standardmäßig sind alle Sicherungsversionen zum Kopieren zugelassen.
CREATED-BEFORE = *LATEST-DATE / <date with compl> / <integer -99999..0 days>(...)
Es werden nur die Sicherungsversionen übernommen, die vor oder an dem angegebenen Datum erstellt wurden. Durch ein zusätzliches Zeitfeld kann die Auswahl besser präzisiert werden.
TIME = 23:59:59 / <time>
Zeit im Format hh:mm:ss
CREATED-AFTER = *EARLIEST-DATE / <date with compl> / <integer -99999..0 days>
Es werden nur die Sicherungsversionen übernommen, die an oder nach dem angegebenen Datum erstellt wurden.
Dieser Operand ermöglicht das sukzessive Duplizieren einer Sicherungsdatei, die über mehrere Tage fortgeschrieben wird. Jeden Tag werden nur die neu hinzugekommenen Sicherungsversionen dupliziert.
SAVE-VERSION-DATE = *LATEST-DATE
Es wird nur die jüngste Sicherungsversion im Archiv (mit dem angegebenen Sicherungsversionsnamen) kopiert.
SAVE-VERSION-DATE = <date with-compl>(...)
Die Sicherungsversion an dem angegebenen Datum und der angegebenen Zeit (mit dem angegebenen Sicherungsversionsnamen) wird kopiert.
Eine 2-stellige Jahreszahl yy wird zu 20yy ergänzt, wenn yy <= 59 ist. Sie wird zu 19yy ergänzt, wenn yy > 59 ist.
TIME = 23:59:59 / <time>
Zeit im Format hh:mm:ss
ORIGINAL-DATE =
Der Operand gilt nur für Sicherungsversionen aus einem Migrations- oder Langzeitarchiv. Er bestimmt die zu kopierende Sicherungsversion über das Datum der Erstmigration bzw. Erstarchivierung. Bei Kopien wird dieses Datum als Ursprungsdatum mitgeführt. Bei der Originalsicherung ist das Ursprungsdatum gleich dem Datum der Sicherungsversion.
ORIGINAL-DATE = *INTERVAL(...)
Schränkt die für die Kopie zugelassenen Sicherungsversionen auf ein Zeitintervall ein, in dem ihr Ursprungsdatum liegen muss.
Standardmäßig sind alle Sicherungsversionen zum Kopieren zugelassen.
BEFORE = *LATEST-DATE / <date with compl> / <integer -99999..0 days>
Es werden nur die Sicherungsversionen übernommen, deren Ursprungsdatum an oder vor dem angegebenen Datum liegt.
AFTER = *EARLIEST-DATE / <date with compl> / <integer -99999..0 days>
Es werden nur die Sicherungsversionen übernommen, deren Ursprungsdatum an oder nach dem angegebenen Datum liegt.
ORIGINAL-DATE = <date with-compl>(...)
Die Sicherungsversion mit dem Ursprungsdatum an dem angegebenen Datum und der angegebenen Zeit wird kopiert. Eine 2-stellige Jahreszahl yy wird zu 20yy ergänzt, wenn yy ≤ 59 ist. Sie wird zu 19yy ergänzt, wenn yy > 59 ist.
TIME = 23:59:59 / <time>
Zeit im Format hh:mm:ss
SELECT-PATHS =
Sie können die Knotendateien angeben, die aus der Sicherungsdatei kopiert werden sollen. Die getroffene Dateiauswahl gilt für alle zu kopierenden Sicherungsversionen der Sicherungsdatei.
SELECT-PATHS = *ALL
Alle Knotendateien werden kopiert.
SELECT-PATHS = *SELECTED
Die Pfadnamen der Knotendateien, die kopiert werden sollen, werden einer Liste entnommen, welche im selben HSMS-Lauf mit der HSMS-Anweisung SELECT-NODE-FILES erstellt wurde.
SELECT-FILES = *FROM-FILE(...)
Die Pfadnamen der Knotendateien, 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-PATHS = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Knotendateien, die kopiert werden sollen, werden einem PLAM-Bibliothekselement (Typ S) entnommen. Das Bibliothekselement enthält pro Satz einen Pfadnamen.
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-PATHS = *PATH-NAME(...)
Der Pfadname der Knotendatei, die kopiert werden soll, wird direkt eingegeben.
PATH = <posix-pathname 1..1023 with-wild>
Pfadname der Knotendatei.
NODE-ID =
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Physische Lage der Knotendatei, die kopiert werden soll.
NODE-ID = *BS2000-UFS
Die Knotendatei liegt auf dem lokalen BS2000-UFS.
NODE-ID = *ALL
Die Knotendatei wird auf dem lokalen BS2000-UFS und auf allen vorhandenen Knoten-S0 gesucht.
NODE-ID = <posix-filename 1..48 with-wild>
Name des Knoten-S0, auf dem die Knotendatei liegt. Der Knoten-S0, der mit //MODIFY-NODE-PARAMETERS definiert ist, ist unter dem Verzeichnis /HSMS/<node-id> im POSIX eingehängt und der Zugriff erfolgt über NFS.
EXCEPT-PATHS =
Sie können Knotendateien angeben, die nicht aus der Sicherungsdatei kopiert werden sollen. Die getroffene Dateiauswahl gilt für alle Sicherungsversionen der Sicherungsdatei, die kopiert werden sollen.
EXCEPT-PATHS = *NONE
Es sollen alle Knotendateien aus der Sicherungsdatei kopiert werden.
EXCEPT-PATHS = *FROM-FILE(...)
Die Pfadnamen der Knotendateien, 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-PATHS = *FROM-LIBRARY-ELEMENT(...)
Die Pfadnamen der Knotendateien, die nicht kopiert werden sollen, werden einem PLAM-Bibliothekselement (Typ S) entnommen. Das Bibliothekselement enthält pro Satz einen Pfadnamen.
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-PATHS = *PATH-NAME(...)
Der Pfadname der Knotendatei, die nicht kopiert werden soll, wird direkt eingegeben.
PATH = <posix-pathname 1..1023 with-wild>
Pfadname der Knotendatei.
NODE-ID =
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung.
Physische Lage der Knotendatei, die ausgeschlossen werden soll.
NODE-ID = *BS2000-UFS
Die Knotendatei liegt auf dem lokalen BS2000-UFS.
NODE-ID = *ALL
Die Knotendatei wird auf dem lokalen BS2000-UFS und auf allen vorhandenen Knoten-S0 gesucht.
NODE-ID = <posix-filename 1..48 with-wild>
Name des Knoten-S0, auf dem die Knotendatei liegt. Der Knoten-S0, der mit //MODIFY-NODE-PARAMETERS definiert ist, ist unter dem Verzeichnis /HSMS/<node-id> im POSIX eingehängt und der Zugriff erfolgt über NFS.
SELECTION-BOUNDARY =
Legt den Umfang der Dateinamensauflösung im Knotendateibaum fest.
SELECTION-BOUNDARY = *ALL-FILE-SYSTEMS
Es werden alle Knotendateien und Dateiverzeichnisse bearbeitet, die beim Operanden PATH-NAMES angegeben sind.
Wenn eines der zu bearbeitenden Objekte ein Dateiverzeichnis ist, werden die Knotendateien und Dateiverzeichnisse, die sich auf allen untergeordneten Ebenen befinden, zusätzlich berücksichtigt.
Die Auswahl von Knotendateien und Dateiverzeichnissen wird im gesamten Dateibaum durchgeführt.
SELECTION-BOUNDARY = *SPECIFIED-PATHS
Es werden alle Knotendateien und Dateiverzeichnisse bearbeitet, die beim Operanden PATH-NAMES angegeben sind.
Bei Dateiverzeichnissen werden nur die Indexeinträge berücksichtigt. Alle Knotendateien und Dateiverzeichnisse, die sich unterhalb dieses Dateiverzeichnisses befinden, werden nicht berücksichtigt.
NEW-PATH-NAMES =
Dieser Operand steht nur dem HSMS-Administrator zur Verfügung. Der HSMS-Administrator kann die Knotendateien unter einen anderen Knoten-S0 kopieren. Beim Umbenennen in Node-Backup-Archiven muss beachtet werden, dass ein Umbenennen von Differenzsicherungen auch das Umbenennen der zugrunde liegenden Vollsicherungen notwendig macht, damit das Differenzsicherungsverfahren beim Restore einwandfrei funktioniert.
NEW-PATH-NAMES = *SAME
Die Knotendateien werden unter den ursprünglichen Knoten-S0 kopiert.
NEW-PATH-NAMES = *BY-RULE(...)
Die Knotendateien werden nach einer einheitlichen Vorschrift umbenannt.
NEW-NODE-ID = *SAME / *BS2000-UFS / <posix-filename 1..48 without-wild>
Sie können die Knotendateien unter einen anderen Knoten-S0 kopieren. Standardmäßig werden die Knotendateien unter den ursprünglichen Knoten-S0 kopiert. Die explizite Angabe eines neuen Knoten-S0 ist nur möglich, wenn der ursprüngliche Knoten-S0 im Operanden SELECT-PATHS angegeben wurde (Angabe ungleich *ALL bzw. *PATH-NAME(...,NODE-ID=*ALL).
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>(...)
Name des Archivs, von dem die Sicherungsdatei kopiert werden soll. Das angegebene Archiv muss eingerichtet sein. Bei nicht-privilegiertem Aufruf muss der Aufrufer Eigentümer oder über das Verzeichnis Miteigentümer des Archivs sein oder das Archiv muss Zugang für alle Benutzer (USER-ACCESS=*ALL-USERS, ACCESS=*READ) bieten.
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.
ENVIRONMENT =
HSMS-Umgebung, in der das Originalarchiv definiert ist.
ENVIRONMENT = *NODE-STD
Die Umgebung wird abgeleitet:
entweder vom Operanden SELECT-PATHS=*PATH-NAME(NODE-ID) oder
von der Liste der Knotenkennungen, auf die in der Datei beim Operanden SELECT-PATHS=*FROM-FILE(LIST-FILE-NAME) oder in dem Bibliothekselement beim Operanden PATH-NAMES=*FROM-LIBRARY-ELEMENT(LIBRARY, ELEMENT) Bezug genommen wird.
Bei einer Workstation ist es die Umgebung, in der die HSMS-Anweisung MODIFY-NODE-PARAMETERS ausgeführt wurde.
Beim BS2000-UFS ist es für einen privilegierten Benutzer die SINGLE-FEATURE-Umgebung; für einen nicht-privilegierten Benutzer nimmt *NODE-STD den Wert der Umgebung an, in der das Home-Verzeichnis des Benutzers definiert ist.
Wenn sich die betreffenden Knotendateien auf verschiedenen Umgebungen befinden, wird die Anweisung mit der Meldung HSM0530 zurückgewiesen.
ENVIRONMENT = *SINGLE-FEATURE
Das Archiv ist in der SF-Umgebung definiert.
ENVIRONMENT = *SYSTEM-MANAGED(...)
Die Anweisung ist in der angegebenen SM-Pubset-Umgebung gültig.
CATALOG-ID = <cat-id>
Katalogkennung des SM-Pubsets, für den die Anweisung gültig ist.
TO-ARCHIVE-NAME =
Name des Archivs, in das die Sicherungsdatei kopiert werden soll.
TO-ARCHIVE-NAME = *SAME
Die Sicherungsdatei wird in das Archiv kopiert, das beim Operanden ARCHIVE-NAME angegeben ist.
TO-ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>(...)
Die Sicherungsdatei wird in das angegebene Archiv kopiert. Das angegebene Archiv muss eingerichtet sein. Bei nicht-privilegiertem Aufruf muss der Aufrufer Eigentümer oder über das Verzeichnis Miteigentümer des Archivs sein oder das Archiv muss Zugang für alle Benutzer (USER-ACCESS=*ALL-USERS, ACCESS=*READ) bieten.
ENVIRONMENT =
HSMS-Umgebung, in der das Zielarchiv definiert ist.
ENVIRONMENT = *SAME
Das Archiv ist in derselben Umgebung wie das ursprüngliche Archiv definiert.
ENVIRONMENT = *SINGLE-FEATURE
Das Archiv ist in der SF-Umgebung definiert.
ENVIRONMENT = *SYSTEM-MANAGED(...)
Das Archiv ist in der angegebenen SM-Pubset-Umgebung definiert.
CATALOG-ID = <cat-id>
Katalogkennung der SM-Pubset-Umgebung
SAVE-FILE =
Legt die Sicherungsdatei fest, in der die kopierte Sicherungsdatei abgelegt werden soll.
SAVE-FILE = *NEW(...)
Die kopierte Sicherungsdatei wird in einer neu zu erstellenden Sicherungsdatei abgelegt. Für diese Sicherungsdatei können Sie folgende Attribute festlegen:
RETENTION-PERIOD = *STD / <integer 0..16383 days> / *FROM-ORIGINAL-SAVE-FILE
(Physische) Schutzfrist in Tagen. Während dieser Schutzfrist dürfen die Sicherungsdatei und -datenträger nicht verändert oder gelöscht werden.
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
RETENTION-PERIOD = *FROM-ORIGINAL-SAVE-FILE
Die neue Sicherungsdatei erhält die Schutzfrist der Original-Sicherungsdatei.
SAVE-FILE = *CONTINUE(...)
Die angegebene Sicherungsdatei wird fortgeschrieben.
Wenn in dasselbe Archiv kopiert wird, müssen die Ausgabe-Sicherungsdatei und die Eingabe-Sicherungsdatei verschieden sein.
SAVE-FILE-ID = *LATEST
Die zuletzt erstellte Sicherungsdatei des Archivs wird fortgesetzt.
SAVE-FILE-ID = <composed-name 15..15>
Die angegebene Sicherungsdatei wird fortgeschrieben. Die Save-File-ID müssen Sie in folgendem Format angeben: S.yymmdd.hhmmss
TO-STORAGE =
Speicherebene, auf die die Sicherungsdatei kopiert wird.
Sicherungsdateien aus Langzeit- und Migrationsarchiven können Sie nur nach S2 kopieren. Sicherungsdateien aus Backup-Archiven können Sie auch nach S2, S1 und auf Privatplatte kopieren.
TO-STORAGE = *S2-STORAGE-LEVEL(...)
Die Sicherungsdatei wird auf die Speicherebene S2 kopiert. Sie können die Datenträger näher bestimmen. 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 Archivs entnommen, d.h. dem Pool des Archivverzeichnisses oder dem zugeordneten MAREN-Pool.
VOLUMES = *FROM-OPERATOR
Der Operator weist die Datenträger bei Anforderung zu.
VOLUMES = list-poss(10): <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. Standardmäßig gilt die Voreinstellung aus der Archivdefinition (Operand S2-DEVICE-TYPE).
LOCATION = *STD / *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 oder aber *STD, wenn *ANY der standardmäßige Lagerort des Archivs ist.
LOCATION = *STD
Der standardmäßige Lagerort des Archivs wird verwendet.
LOCATION = *ANY
Es soll kein Lagerort verwendet werden.
OPERATION-CONTROL =
Sie können Parameter für den Ablauf dieses Kopierauftrags 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 Kopierlaufs ä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 „CNF#“ und der TSN des aufrufenden Benutzerauftrags yyyy in der Form: CNF#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 Anweisungen nur während der Bandverarbeitungszeiten zugelassen.
PARALLEL-RUNS = *MAXIMUM / <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 (*MAXIMUM) gilt der Wert, der beim Erstellen der zu kopierenden Sicherungsdatei verwendet wurde.
Nähere Informationen zur parallelen Verarbeitung finden Sie im Handbuch „HSMS Bd. 1“ [1].
OPERATOR-INTERACTION = *STD / *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).
Standardmäßig gilt die Voreinstellung aus der Archivdefinition.
TAPE-CONTROL =
Legt Parameter für das Kopieren auf Magnetband fest.
TAPE-CONTROL = *STD
Es gelten jeweils die Voreinstellungen aus der Definition des Archivs, innerhalb dessen kopiert wird.
TAPE-CONTROL = *PARAMETERS(...)
Sie können folgenden Operanden für das Kopieren auf Magnetband ändern:
BLOCKING-FACTOR = *STD / <integer 2..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.
Die Voreinstellung *STD wählt den Blockungsfaktor aus der Archivdefinition. Enthält diese ebenfalls die Standardeinstellung, 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 = *STD / *YES / *NO
Bestimmt, ob ein Magnetband nach dem Ende der Verarbeitung entladen wird oder nicht. Dies gilt sowohl für Eingabe- als auch Ausgabebänder. Die Voreinstellung aus der Archivdefinition des Zielarchivs gilt als Standardwert
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 Kopierauftrag ausgegeben werden soll.
REPORT = *SUMMARY
Ausgegeben wird eine Zusammenfassung des Ergebnisses des Kopierauftrags mit eventuellen Fehlermeldungen.
REPORT = *FULL
Ausgegeben wird ein Report in vollem Umfang mit einer Liste auch der Knotendateien, die katalogisiert sind, aber nicht gesichert wurden, weil sie sich seit der letzten Sicherung nicht geändert haben. Beim Kopieren ohne Dateiselektion oder Umbenennung von Dateien im gleichen Archiv oder ins Schattenarchiv wird die Angabe in REPORT=*SUMMARY umgewandelt.
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 Kopierauftrags 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 Kopierauftrags 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 Kopierauftrags 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 Kopierauftrags 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.
Bei einer SM-Pubset-Umgebung wird dem Dateinamen die Katalogkennung der Umgebung hinzugefügt, wenn im Report-Dateinamen keine Katalogkennung angegeben ist.
Beispiel
Ein HSMS-Verwalter kopiert die letzte Sicherungsversion mit Knotendateien auf die Speicherebene S2.
//COPY-NODE-SAVE-FILE ARCHIVE-NAME=NODE.BACKUP, - // SELECT-SAVE-VERSIONS=*BY-ATTRIBUTES(SAVE-VERSION-DATE=*DATE)
Wenn innerhalb desselben Backup-Archivs kopiert wird, kann nur die letzte Sicherungsversion kopiert werden.
Alle Knotendateien der letzten Sicherungsdatei des Archivs „NODE.BACKUP“ werden in eine neue Sicherungsdatei auf S2 kopiert. Sie Sicherung erfolgt auf Datenträger aus dem Datenträger-Pool des Archivs.
Je nach globalem HSMS-Parameter-OUTPUT wird eine Zusammenfassung gedruckt oder als Anhang einer E-Mail verschickt.