RESTORE	Dateien von Archive-Sicherung auf Platte zurückholen

ONXRESTORE ['str1'=...,] [STATE] [,TO=PUBLIC|vsn|(vsn, ...)] [,DEVICE=dev] [,ENV-ATT= FROM-TARGET|FROM-ORIGIN] [,CONV=NO|STD|CONV] [,REP=YES|NO|ALL| ALLP] [,SPACE=REORG|KEEP] [,PASSWORD= ...] [,DIR=NONE] [_PARAM_....]

	Die Variable Action ONXRESTORE kann nur in einer mit DIR directory ausgewählten Archive-Directory Liste angegeben werden. Mit RESTORE werden Sicherungsstände von Dateien/Jobvariablen, die mit der Archive-Anweisungen SAVE/DSAVE gesichert wurden, unter dem gleichen bzw. mit einem anderen Namen wieder in das System eingespielt.

	'str1'= ...	Namenstransformationsregeln. Näheres siehe Seite 5-.

		'str1'='str2' | 'str1'=DP[n][I] | 'str1'=DS[n][I]

	STATE	Entspricht dem Archive-Operanden FROM=...,STATE in der Anweisung RESTORE/ DRESTORE. Der Parameter STATE hat eine Bedeutung nur bei Sicherungseinträgen vom Typ PART (Teilsicherung). Er bewirkt, daß beim Restaurieren einer Datei zunächst der letzte Vollsicherungsstand der Datei und anschließend die in der Teilsicherung geänderten Seiten eingespielt werden.

	TO=PUBLIC|vsn|(vsn,...)

		Entspricht dem Archive-Operanden TO=... in der Anweisung FILES.

		Der Parameter TO= bewirkt, daß beim Restaurieren die Dateien auf dem bzw. den angegebenen privaten Datenträgern bzw. im Public-Speicher eingerichtet werden.

		Standard: Bei Fehlen des TO= Operanden, werden die Dateien, die von privaten Datenträgern gesichert wurden, wieder auf die ursprünglichen Datenträger zurückgeschrieben. Dateien, die von gemeinschaftlichen Datenträgern gesichert wurden, werden wieder im Public-Bereich eingerichtet.

	DEVICE=dev	Nur im Zusammenhang mit Parameter TO=vsn (s.o.). Hier wird der Gerätetyp des bzw. der bei TO= angegebenen privaten Datenträger angegeben.

	ENV-ATT=FROM-TARGET|FROM-ORIGIN

		Entspricht dem Archive-Operanden ENVIRONMENT-ATTRIBUTES in der Anweisung [D]RESTORE.

		Mit diesem Parameter wird gesteuert, wie RESTORE mit Dateien verfährt, die bereits existieren und mit ACL, BACL oder GUARDS geschützt sind.

	CONV=NO|STD|CONV

		Entspricht dem Archive-Operanden CONVERSION in der Anweisung [D]RESTORE.

		Mit diesem Parameter wird gesteuert, ob Dateien, die vor der Sicherung einen PAM-Schlüssel hatten, konvertiert werden sollen, wenn der Ausgabedatenträger eine NK-Platte ist.

	REP=YES|NO|ALL|ALLP

		Entspricht dem Archive-Operanden REPLACE=... in der Anweisung [D]RESTORE.

		Mit diesem Parameter wird gesteuert, ob vorhandene Dateien/Jobvariablen gleichen Namens beim Rückschreiben ersetzt werden sollen oder nicht. Für weitere Informationen wird auf das ARCHIVE-Handbuch, Anweisung RESTORE verwiesen.

	SPACE=REORG|KEEP

		Entspricht dem Archive-Operanden SPACE=... in der Anweisung [D]RESTORE.

		Mit diesem Parameter wird gesteuert, ob die aus der Sicherung zu ersetzenden Dateien vor dem Zurückschreiben gelöscht werden sollen. Für weitere Informationen wird auf das ARCHIVE-Handbuch, Anweisung RESTORE verwiesen.

	PASSWORD=passw|(passw,...)

		Entspricht dem Archive-Operanden PASSWORD=... in der Anweisung [D]RESTORE.

		Hier sind ein bzw. mehrere Lesekennworte für gesicherte Dateien anzugeben. Der Systemverwalter braucht die Lesekennworte nicht anzugeben. Für weitere Informationen wird auf das ARCHIVE-Handbuch, Anweisung RESTORE verwiesen.

	DIR=NONE	Dieser Parameter bewirkt, daß beim Restore mit ARCHIVE keine Directory-Datei benötigt wird. Dies bedeutet, daß die erzeugte DO-Prozedur in der ARCHIVE Restore-Anweisung die VSN's der Bänder enthält, die zum Rücksichern der Dateien benötigt werden sowie den entsprechenden Device-Typ. Als Hinweis an den Operator zum Bereitstellen der benötigten Bänder werden per TYPE entsprechende Meldungen an CONSOLE ausgegeben.

		Ein Anwendungsfall für den Parameter DIR=NONE besteht darin, an einem Host eine ARCHIVE Restore-Prozedur zum Zurücksichern bestimmter Dateien zu erzeugen. Diese Prozedur kann mit File-Transfer auf einen anderen Host übertragen und dort zur Ausführung gebracht werden. Die gewünschten Dateien werden auf dem fremden Host ohne Directory-Datei zurückgesichert. Vorausgesetzt wird lediglich der Zugriff auf die benötigten Archive-Bänder.

	PARAM ...	Entspricht der Archive-Anweisung PARAM in einem RESTORE-Lauf.

		Hier können allgemeine Archive-Einstellungen angegeben werden, wie z.B. OPERATOR=YES|NO,RESTART=YES|NO,WRCHK=YES|NO,SNR=YES|NO,STREAM=YES|NO,UNLOAD=YES|NO. Für weitere Informationen zur Bedeutung der einzelnen Parameter wird auf das ARCHIVE-Handbuch, Anweisung PARAM verwiesen.

		Der Operand CATID=YES|NO darf in der PARAM-Anweisung nicht angegeben werden, da er von CFS selbst gesetzt wird gemäß der im Archive-Directory vermerkten Einstellung.

		Die Anweisung PARAM darf nur als letztes angegeben werden und muß mit einem Blank von den vorhergehenden Parametern getrennt werden.

	Hinweise:

	Mit ONXRESTORE können nur Dateien/Jobvariablen aus einer Archive-Directory Liste von CFS auf Platte zurückgeholt werden, die mit der Archive-Anweisung SAVE bzw. DSAVE gesichert wurden. Dateien, die mit EXPORT gesichert wurden, müssen mit der Variablen Action ONXIMPORT, siehe Seite 5- restauriert werden.

	Falls mehrere Sicherungsversionen derselben Datei mit ONXRESTORE zurückgesichert werden, so wird die erste Sicherungsversion unter dem originalen Dateinamen erstellt. Die weiteren Sicherungsversionen werden als Dateien erstellt, wobei dem Originalnamen die Suffix '.$$nn' angehängt wird. nn ist hierbei eine fortlaufende Nummer welche mit 01 beginnt.