Query-filespace operation
The query-filespace operation displays a list of file spaces for a node that is stored on the IBM Tivoli Storage Manager server. You can also query using a single files pace name. IBM Tivoli Storage Manager assigns a separate file space on the server for each drive on your computer from where you backup or archive files.
The following table describes the elements for the query-filespace request:
Adapter request elements for the query-filespace operation
The following figure shows a sample adapter request for the query-filespace operation:
Sample adapter request for the query-filespace operation
<tsm-request>
<operation-name>query-filespace</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<dateformat>MM/DD/YYYY</dateformat>
<timeformat>HH:MM:SS</timeformat>
<detail />
</command-options>
</command-request>
</tsm-request>
<operation-name>query-filespace</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<dateformat>MM/DD/YYYY</dateformat>
<timeformat>HH:MM:SS</timeformat>
<detail />
</command-options>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the query-filespace operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query filespace -dateformat=1 -timeformat=1 - detail</command>
<line-count>12</line-count>
<execution-milliseconds>1375</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: 10/10/2008 16:33:46</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: L-16862</line>
<line index="7">Session established with server L-16862_SERVER1: Windows</line>
<line index="8"> Server Version 5, Release 5, Level 0.0</line>
<line index="9"> Server date/time: 10/10/2008 16:33:46 Last access: 10/10/2008 16:07:31</line>
<line index="10"> # Last Incr Date Type fsID Unicode File Space Name</line>
<line index="11">--- -------------- ---- ---- ------- ----- ----------</line>
<line index="12"> 1 00/00/0000 00:00:00 NTFS 1 Yes \\l- 16862\c$</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query filespace -dateformat=1 -timeformat=1 - detail</command>
<line-count>12</line-count>
<execution-milliseconds>1375</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: 10/10/2008 16:33:46</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: L-16862</line>
<line index="7">Session established with server L-16862_SERVER1: Windows</line>
<line index="8"> Server Version 5, Release 5, Level 0.0</line>
<line index="9"> Server date/time: 10/10/2008 16:33:46 Last access: 10/10/2008 16:07:31</line>
<line index="10"> # Last Incr Date Type fsID Unicode File Space Name</line>
<line index="11">--- -------------- ---- ---- ------- ----- ----------</line>
<line index="12"> 1 00/00/0000 00:00:00 NTFS 1 Yes \\l- 16862\c$</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*