The retrieve command obtains copies of archived files from the Tivoli® Storage Manager server. You can retrieve specific files or entire directories.
Use the description option to specify the descriptions that are assigned to the files you want to retrieve.
Use the pick option to display a list of your archives from which you can select an archive to retrieve.
Retrieve the files to the same directory from which they were archived, or to a different directory. Tivoli Storage Manager uses the preservepath option with the subtree value as the default for restoring files.
dsmc retrieve c:\doc\h2.doc \\star\c$\
The
workstation named star has been renamed and the new name is meteor.
To retrieve the c:\doc\h2.doc file to meteor,
you would enter: dsmc retrieve c:\doc\h2.doc \\meteor\c$\
You
could also enter: dsmc retrieve c:\doc\h2.doc \\star\c$\
You
can enter the command in either of the preceding ways because if the
workstation name is not included in the specification, the local workstation
is assumed (meteor, in this case).This command is valid for all clients.
>>-RETrieve--+------------+--+- --sourcefilespec---+------------> '- --options-' '- --"sourcefilespec"-' >--+------------------------+---------------------------------->< '- --destinationfilespec-'
>>-RETrieve--+------------+-------------------------------------> '- --options-' >--+- --sourcefilespec----------------------+-------------------> '- --{--filespacename--}--sourcefilespec-' >--+------------------------+---------------------------------->< '- --destinationfilespec-'
This failure can also occur if you remove the virtualmountpoint option from the dsm.sys file. In this case, you can specify a different destination, or restore the original virtualmountpoint option to the dsm.sys file, restart the client, and try the command again.
Option | Where to use |
---|---|
dateformat | Client options file (dsm.opt) or command line. |
dateformat | Client user options file (dsm.opt) or command line. |
description | Command line only. |
dirsonly | Command line only. |
filelist | Command line only. |
filesonly | Command line only |
followsymbolic | Client user options file (dsm.opt) or command line. |
fromdate | Command line only |
fromnode | Command line only. |
fromowner | Command line only |
fromtime | Command line only |
ifnewer | Command line only |
pick | Command line only. |
preservepath | Command line only. |
replace | Client options file (dsm.opt) or command line. |
replace | Client user options file (dsm.opt) or command line. |
skipntpermissions | Client options file (dsm.opt) or command line |
skipntsecuritycrc | Client options file (dsm.opt) or command line |
subdir | Client options file (dsm.opt) or command line. |
subdir | Client user options file (dsm.opt) or command line. |
tapeprompt | Client options file (dsm.opt) or command line. |
tapeprompt | Client user options file (dsm.opt) or command line. |
timeformat | Client options file (dsm.opt) or command line. |
timeformat | Client user options file (dsm.opt) or command line. |
todate | Command line only. |
totime | Command line only. |
retrieve /home/devel/projecta/budget
ret c:\devel\projecta\budget.fin
retrieve "/home/devel/projecta/*.c"
ret c:\devel\projecta\*.c
ret {winnt}\devel\projecta\*.c
retrieve /home/
ret c:\devel\*
ret {abc}\proj\*.*
retrieve "/home/devel/projecta/*.c" /home/newdevel/projectn/
ret c:\devel\projecta\*.c c:\newdevel\projectn\
ret "/user/project/*" -pick
ret c:\project\* -pick
retrieve "/proj/*" -desc="2012 survey results"
mkfifo fifo
dd if=fifo of=/dev/rmt1&
dsmc retrieve -replace=yes -description="mybudget"
/home/devel/budget fifo
ret Jaguar_OLD/user5/Documents/myresume.doc /Users/user5/Documents/
ret \\your-node\h$_OLD\docs\myresume.doc h:\docs\