Retrieve

Mit dem Befehl retrieve werden Kopien archivierter Dateien vom IBM Spectrum® Protect -Server abgerufen. Es können bestimmte Dateien oder vollständige Verzeichnisse abgerufen werden.

Mit der Option description können die Beschreibungen angegeben werden, die den abzurufenden Dateien zugeordnet sind.

Verwenden Sie die Option pick, um eine Liste Ihrer Archivierungen anzuzeigen, aus der Sie eine Archivierung zum Abrufen auswählen können.

Rufen Sie die Dateien in dasselbe Verzeichnis ab, in dem sie archiviert wurden, oder in ein anderes Verzeichnis. Der Client für Sichern/Archivieren verwendet die Option preservepath mit dem Wert subtree als Standardwert für das Zurückschreiben von Dateien.

Hinweis: Wenn ein Verzeichnis abgerufen wird, wird sein Änderungsdatum und seine Änderungszeit auf das Datum und die Uhrzeit des Abrufs gesetzt, nicht auf das Datum und die Uhrzeit, an dem bzw. zu der das Verzeichnis archiviert wurde. Die Ursache dafür ist, dass der Client für Sichern/Archivieren zuerst die Verzeichnisse abruft und anschließend die Dateien zu den Verzeichnissen hinzufügt.

Hinweis:

Wird ein Verzeichnis abgerufen, werden das Datum und die Uhrzeit des Abrufs als Änderungsdatum und Änderungszeit festgelegt und nicht das Datum und die Uhrzeit des Verzeichnisses bei seiner Archivierung. Die Ursache dafür ist, dass der Client für Sichern/Archivieren zuerst die Verzeichnisse abruft und anschließend die Dateien zu den Verzeichnissen hinzufügt.
Wird versucht, eine Datei abzurufen, deren Name mit dem Kurznamen einer vorhandenen Datei identisch ist, tritt ein Fehler auf. Wenn Sie beispielsweise versuchen, eine Datei mit dem spezifischen Namen ABCDEF~1.DOC in demselben Verzeichnis abzurufen, in dem sich auch eine Datei mit dem Namen abcdefghijk.doc befindet, schlägt der Abruf fehl, weil das Windows-Betriebssystem die Datei abcdefghijk.doc mit dem Kurznamen ABCDEF~1.DOCgleichsetzt. Die Abruffunktion behandelt dies als doppelte Datei.
Wenn dieser Fehler auftritt, kann er mit einer der folgenden Maßnahmen korrigiert werden:
- Die Datei mit dem angegebenen Kurzdateinamen an eine andere Position abrufen.
- Den Abruf stoppen und den Namen der vorhandenen Datei ändern.
- Inaktivieren Sie die Unterstützung für kurze Dateinamen unter Windows.
- Keine Dateinamen verwenden, die mit der Kurzdateinamenskonvention unverträglich sind. Verwenden Sie z. B. nicht ABCDEF~1.DOC.

Der Workstationname ist Bestandteil des Dateinamens. Daher muss ein Zielort angegeben werden, wenn Dateien auf einer Workstation archiviert werden und auf einer anderen Workstation abgerufen werden sollen. Dies gilt auch, wenn auf derselben physischen Workstation abgerufen wird, die Workstation jedoch einen neuen Namen hat. Soll beispielsweise die Datei c:\doc\h2.doc in ihr Ursprungsverzeichnis auf der Workstation mit dem Namen 'star' abgerufen werden, geben Sie Folgendes ein:

   dsmc retrieve c:\doc\h2.doc \\star\c$\

Die Workstation 'star' wurde umbenannt und der neue Name lautet 'meteor'. Um die Datei c:\doc\h2.doc nach 'meteor' abzurufen, geben Sie Folgendes ein:

   dsmc retrieve c:\doc\h2.doc \\meteor\c$\

Folgende Eingabe ist auch möglich:

   dsmc retrieve c:\doc\h2.doc \\star\c$\

Beide Befehle können verwendet werden, da die lokale Workstation (in diesem Fall meteor) angenommen wird, wenn kein Workstationname im Befehl angegeben wird.

Unterstützte Clients

Dieser Befehl ist für alle Clients gültig.

Syntax für UNIX und Linux®

Syntax für Windows

Parameter

Quellendateispezifikation

Gibt den Pfad und Dateinamen an, die Sie abrufen wollen. Es können Platzhalterzeichen verwendet werden, um eine Dateigruppe oder alle Dateien in einem Verzeichnis anzugeben.

Quellendateispezifikation

Gibt den Pfad und den Namen der Datei an, die abgerufen werden soll. Es können Platzhalterzeichen verwendet werden, um eine Dateigruppe oder alle Dateien in einem Verzeichnis anzugeben.

Anmerkung: Wenn Sie Dateibereichsnameangeben, darf die Dateispezifikation keinen Laufwerkbuchstaben enthalten.

{Dateibereichsname}

Gibt den in geschweiften Klammern eingeschlossenen Dateibereich auf dem Server an, in dem sich die abzurufenden Dateien befinden. Dieser Name ist die Laufwerkbezeichnung des Workstationlaufwerks, aus dem die Dateien archiviert wurden.

Sie verwenden den Dateibereichsnamen, wenn sich die Laufwerkbezeichnung geändert hat oder wenn Sie Dateien abrufen, die aus einem anderen Knoten archiviert wurden, dessen Laufwerkbezeichnungen sich von Ihren unterscheiden.

Anmerkung: Sie müssen einen NTFS-oder ReFS-Dateibereichsnamen in Groß-oder Kleinschreibung angeben, der in Anführungszeichen und geschweifte Klammern eingeschlossen ist. Zum Beispiel {"NTFSDrive"}. Hochkommas oder Anführungszeichen sind im Schleifenmodus gültig. Beispielsweise ist sowohl {"NTFSDrive"} als auch {'NTFSDrive'} gültig. Im Stapelmodus sind nur Hochkommas gültig. Die Einschränkung auf einfache Anführungszeichen ist im Betriebssystem begründet.

Zieldateispezifikation

Gibt den Pfad und den Namen der Datei an, in die die Dateien geschrieben werden. Wenn Sie kein Ziel angeben, schreibt der Client die Dateien in den ursprünglichen Quellenpfad zurück.

Anmerkung: Wenn Sie kein Ziel angeben, bestimmt der Client für Sichern/Archivieren, ob das ursprüngliche Dateisystem erreicht werden kann. Kann das ursprüngliche Dateisystem nicht erreicht werden, schreibt der Client die Datei nicht zurück.

Oracle Solaris-Betriebssysteme Linux-Betriebssysteme AIX-Betriebssysteme Dieser Fehler kann auch auftreten, wenn Sie die Option virtualmountpoint aus der Datei dsm.sys entfernen. In diesem Fall können Sie einen anderen Zielort angeben oder die ursprüngliche Option virtualmountpoint in die Datei dsm.sys wiederherstellen, den Client erneut starten und den Befehl wiederholen.

Zieldateispezifikation

Gibt den Pfad und Dateinamen an, in dem die Dateien gespeichert werden sollen. Wenn Sie kein Ziel angeben, schreibt der Client die Dateien in den ursprünglichen Quellenpfad zurück.

Beachten Sie bei der Eingabe der Zieldateispezifikation Folgendes:

Wenn die Quellendateispezifikation eine einzelne Datei benennt, kann die Zieldateispezifikation eine Datei oder ein Verzeichnis sein.
Wenn die Quellendateispezifikation Platzhalterzeichen enthält oder wenn Sie die Option subdir=yes angeben, muss die Zieldateispezifikation ein Verzeichnis sein und mit einem Verzeichnisbegrenzer (\) enden.

Hinweis: Wenn der Zielpfad oder ein Teil davon nicht vorhanden ist, wird er vom Client erstellt.

Tabelle 1. Befehl Retrieve: Zugehörige Optionen
Option	Verwendung
dateformat	-Clientoptionsdatei (dsm.opt) oder Befehlszeile.
dateformat	Clientbenutzeroptionsdatei (dsm.opt) oder Befehlszeile.
description	Nur in der Befehlszeile.
dirsonly	Nur in der Befehlszeile.
filelist	Nur in der Befehlszeile.
filesonly	Nur in der Befehlszeile.
followsymbolic	Clientbenutzeroptionsdatei (dsm.opt) oder Befehlszeile.
fromdate	Nur in der Befehlszeile.
fromnode	Nur in der Befehlszeile.
fromowner	Nur Befehlszeile
fromtime	Nur in der Befehlszeile.
ifnewer	Nur in der Befehlszeile.
pick	Nur in der Befehlszeile.
preservepath	Nur in der Befehlszeile.
replace	-Clientoptionsdatei (dsm.opt) oder Befehlszeile.
replace	Clientbenutzeroptionsdatei (dsm.opt) oder Befehlszeile.
skipntpermissions	-Clientoptionsdatei (dsm.opt) oder Befehlszeile
skipntsecuritycrc	-Clientoptionsdatei (dsm.opt) oder Befehlszeile
subdir	-Clientoptionsdatei (dsm.opt) oder Befehlszeile.
subdir	Clientbenutzeroptionsdatei (dsm.opt) oder Befehlszeile.
tapeprompt	-Clientoptionsdatei (dsm.opt) oder Befehlszeile.
tapeprompt	Clientbenutzeroptionsdatei (dsm.opt) oder Befehlszeile.
timeformat	-Clientoptionsdatei (dsm.opt) oder Befehlszeile.
timeformat	Clientbenutzeroptionsdatei (dsm.opt) oder Befehlszeile.
todate	Nur in der Befehlszeile.
totime	Nur in der Befehlszeile.

Beispiele

Task

Rufen Sie eine einzelne Datei namens budgetab.

retrieve /home/devel/projecta/budget

Task

Eine einzelne Datei mit dem Namen budget.finabrufen.

ret c:\devel\projecta\budget.fin

Task

Rufen Sie alle Dateien mit der Erweiterung .c aus dem Verzeichnis /home/devel/projecta ab.

retrieve "/home/devel/projecta/*.c"

Task

Rufen Sie alle Dateien mit der Erweiterung .c aus dem Verzeichnis c:\devel\projecta ab.

ret c:\devel\projecta\*.c

Task

Rufen Sie alle Dateien mit der Dateierweiterung .c aus dem Verzeichnis \devel\projecta im Dateibereich winnt ab.

ret {winnt}\devel\projecta\*.c

Task

Rufen Sie alle Dateien im Verzeichnis /home ab.

retrieve /home/

Task

Rufen Sie alle Dateien im Verzeichnis c:\devel ab.

ret c:\devel\*

Task

Dateien aus dem Verzeichnis abc Dateibereich proj abrufen.

ret {abc}\proj\*.*

Task

Rufen Sie alle Dateien mit der Dateierweiterung .c aus dem Verzeichnis /home/devel/projecta in das Verzeichnis /home/newdevel/projectn/projecta ab. Ist das Verzeichnis /projectn oder /projectn/projecta nicht vorhanden, wird es erstellt.

retrieve "/home/devel/projecta/*.c" /home/newdevel/projectn/

Task

Rufen Sie alle Dateien mit der Dateierweiterung .c aus dem Verzeichnis c:\devel\projecta in das Verzeichnis c:\newdevel\projectn\projecta ab. Ist das Verzeichnis \projectn oder \projectn\projecta nicht vorhanden, wird es erstellt.

ret c:\devel\projecta\*.c c:\newdevel\projectn\

Task

Rufen Sie Dateien im Verzeichnis /user/project ab. Verwenden Sie die Option pick .

ret "/user/project/*" -pick

Task

Dateien im Verzeichnis c:\project abrufen. Verwenden Sie die Option pick .

ret c:\project\* -pick

Task

Rufen Sie alle Dateien ab, die aus dem Verzeichnis /proj mit der Beschreibung 2012 survey resultsarchiviert wurden.

retrieve "/proj/*" -desc="2012 survey results"

Task

Archivierte Datei /home/devel/budget mit der Beschreibung "my budget" für das /dev/rmt1 -Bandlaufwerk abrufen.

mkfifo fifo
dd if=fifo of=/dev/rmt1&
dsmc retrieve -replace=yes -description="mybudget"
/home/devel/budget fifo

Task

Eine Datei aus dem umbenannten Dateibereich Jaguar_OLD an ihre ursprüngliche Position abrufen. Geben Sie sowohl die Quelle als auch das Ziel wie folgt ein:

ret Jaguar_OLD/user5/Documents/myresume.doc /Users/user5/Documents/

Task

Eine Datei aus dem umbenannten Dateibereich \\your-node\h$_OLD an ihre ursprüngliche Position abrufen. Geben Sie sowohl die Quelle als auch das Ziel wie folgt ein:

ret \\your-node\h$_OLD\docs\myresume.doc h:\docs\