Restore-backupset operation
The restore-backupset operation restores a backupset from the server, a local file, or a local tape device.
The following table describes the elements for the restore-backupset request:
Adapter request elements for the restore-backupset operation
The following figure shows a sample adapter request for the restore-backupset operation:
Sample adapter request for the restore-backupset operation
<tsm-request>
<operation-name>restore-backupset</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<location>server</location>
<backupsetname>testset2</backupsetname>
<preservepath>Complete</preservepath>
<quiet />
<replace>yes</replace>
<skipntpermissions>yes</skipntpermissions>
</command-options>
</command-request>
</tsm-request>
<operation-name>restore-backupset</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<location>server</location>
<backupsetname>testset2</backupsetname>
<preservepath>Complete</preservepath>
<quiet />
<replace>yes</replace>
<skipntpermissions>yes</skipntpermissions>
</command-options>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the restore-backupset operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc restore backupset -location=server - backupsetname=TESTSET4.21511 -preservepath=Complete -quiet -replace=yes -skipntpermissions=yes</command>
<line-count>17</line-count>
<execution-milliseconds>4589</execution-milliseconds>
<exit-code>0</exit-code>
<status>success</status>
</metadata>
<output>
<line index="1">IBM Tivoli Storage Manager</line>
<line index="2">Command Line Backup/Archive Client Interface</line>
<line index="3"> Client Version 5, Release 5, Level 0.0 </line>
<line index="4"> Client date/time: 12/05/2008 16:14:07</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: RHEL3VM</line>
<line index="7">Session established with server SERVER1: Linux/i386</line>
<line index="8"> Server Version 5, Release 5, Level 0.0</line>
<line index="9"> Server date/time: 12/05/2008 16:14:07 Last access: 12/05/2008 16:13:16</line>
<line index="10">ANS1247I Waiting for files from the server...</line>
<line index="11">Total number of objects restored: 1</line>
<line index="12">Total number of objects failed: 0</line>
<line index="13">Total number of bytes transferred: 186 B</line>
<line index="14">Data transfer time: 0.00 sec</line>
<line index="15">Network data transfer rate: 8,649.55 KB/sec</line>
<line index="16">Aggregate data transfer rate: 0.05 KB/sec</line>
<line index="17">Elapsed processing time: 00:00:03</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc restore backupset -location=server - backupsetname=TESTSET4.21511 -preservepath=Complete -quiet -replace=yes -skipntpermissions=yes</command>
<line-count>17</line-count>
<execution-milliseconds>4589</execution-milliseconds>
<exit-code>0</exit-code>
<status>success</status>
</metadata>
<output>
<line index="1">IBM Tivoli Storage Manager</line>
<line index="2">Command Line Backup/Archive Client Interface</line>
<line index="3"> Client Version 5, Release 5, Level 0.0 </line>
<line index="4"> Client date/time: 12/05/2008 16:14:07</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: RHEL3VM</line>
<line index="7">Session established with server SERVER1: Linux/i386</line>
<line index="8"> Server Version 5, Release 5, Level 0.0</line>
<line index="9"> Server date/time: 12/05/2008 16:14:07 Last access: 12/05/2008 16:13:16</line>
<line index="10">ANS1247I Waiting for files from the server...</line>
<line index="11">Total number of objects restored: 1</line>
<line index="12">Total number of objects failed: 0</line>
<line index="13">Total number of bytes transferred: 186 B</line>
<line index="14">Data transfer time: 0.00 sec</line>
<line index="15">Network data transfer rate: 8,649.55 KB/sec</line>
<line index="16">Aggregate data transfer rate: 0.05 KB/sec</line>
<line index="17">Elapsed processing time: 00:00:03</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*