Query-backupset operation
The query-backupset operation queries a backup set from a local file, tape device, or the IBM Tivoli Storage Manager server.
The following table describes the elements for the query-backupset operation request:
Adapter request elements for the query-backupset operation
The following figure shows a sample adapter request for the query-backupset operation:
Sample adapter request for the query-backupset operation
<tsm-request>
<operation-name>query-backupset</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<location>server</location>
<backupsetname>testset*</backupsetname>
</command-options>
</command-request>
</tsm-request>
<operation-name>query-backupset</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<location>server</location>
<backupsetname>testset*</backupsetname>
</command-options>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the query-backupset operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query backupset -location=server - backupsetname=testset*</command>
<line-count>18</line-count>
<execution-milliseconds>1748</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:13:16</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:13:16 Last access: 12/05/2008 15:31:35</line>
<line index="10"> Backup Set Name Generation Date Retention Description</line>
<line index="11"> ------------------------------ ------------------- -- -------- -----------</line>
<line index="12"> 1 TESTSET.14116 11/18/2008 11:59:59 365 No Description</line>
<line index="13"> 2 TESTSET.14132 11/18/2008 13:37:53 75 No Description</line>
<line index="14"> 3 TESTSET1.14130 11/18/2008 13:36:13 75 No Description</line>
<line index="15"> 4 TESTSET2.14142 11/18/2008 14:11:34 75 No Description</line>
<line index="16"> 5 TESTSET4.21511 12/02/2008 12:02:43 75 No Description</line>
<line index="17"> 6 TESTSET5.22529 12/03/2008 10:46:59 75 No Description</line>
<line index="18"> 7 TESTSET6.22531 12/03/2008 13:15:17 75 No Description</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query backupset -location=server - backupsetname=testset*</command>
<line-count>18</line-count>
<execution-milliseconds>1748</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:13:16</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:13:16 Last access: 12/05/2008 15:31:35</line>
<line index="10"> Backup Set Name Generation Date Retention Description</line>
<line index="11"> ------------------------------ ------------------- -- -------- -----------</line>
<line index="12"> 1 TESTSET.14116 11/18/2008 11:59:59 365 No Description</line>
<line index="13"> 2 TESTSET.14132 11/18/2008 13:37:53 75 No Description</line>
<line index="14"> 3 TESTSET1.14130 11/18/2008 13:36:13 75 No Description</line>
<line index="15"> 4 TESTSET2.14142 11/18/2008 14:11:34 75 No Description</line>
<line index="16"> 5 TESTSET4.21511 12/02/2008 12:02:43 75 No Description</line>
<line index="17"> 6 TESTSET5.22529 12/03/2008 10:46:59 75 No Description</line>
<line index="18"> 7 TESTSET6.22531 12/03/2008 13:15:17 75 No Description</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*