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>


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>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*