Query-archive operation
The query-archive operation displays a list of archived files and additional information about each file such as the file size, archive date, file specification, expiration date, and description of the archive.
The following table describes the elements for the query-archive operation:
Adapter request elements for the query-archive operation
The following figure shows a sample adapter request for the query-archive operation:
Sample adapter request for the query-archive operation
<tsm-request>
<operation-name>query-archive</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<description>"Test Description"</description>
<filelist>C:\filelist.txt</filelist>
<dateformat>DD-MM-YYYY</dateformat>
<numberformat>d,ddd,dd</numberformat>
<timeformat>HH,MM,SS</timeformat>
<fromdate>30-09-2008</fromdate>
<fromtime>12,00,00</fromtime>
<todate>01-10-2008</todate>
<totime>16,00,00</totime>
<detail />
<filesonly />
</command-options>
</command-request>
</tsm-request>
<operation-name>query-archive</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<description>"Test Description"</description>
<filelist>C:\filelist.txt</filelist>
<dateformat>DD-MM-YYYY</dateformat>
<numberformat>d,ddd,dd</numberformat>
<timeformat>HH,MM,SS</timeformat>
<fromdate>30-09-2008</fromdate>
<fromtime>12,00,00</fromtime>
<todate>01-10-2008</todate>
<totime>16,00,00</totime>
<detail />
<filesonly />
</command-options>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the query-archive operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query archive -description="Test Description" - filelist=C:\filelist.txt -dateformat=2 -numberformat=2 -timeformat=2 - fromdate=30-09-2008 -fromtime=12,00,00 -todate=01-10-2008 - totime=16,00,00 -detail -filesonly</command>
<line-count>15</line-count>
<execution-milliseconds>1860</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: 01-10-2008 11,32,46</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: D-13096</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: 01-10-2008 11,30,49 Last access: 01- 10-2008 10,49,20</line>
<line index="10"> Size Archive Date - Time File - Expires on - Description</line>
<line index="11"> ---- ------------------- -------------- -----------------</line>
<line index="12"> 21 B 01-10-2008 10,49,17 \\d- 13096\c$\tmuninst.ini 01-10-2009 Test Description RetInit:STARTED ObjHeld:NO</line>
<line index="13">Modified: 03-07-2008 13,45,52Created: 14-02-2008 04,26,38</line>
<line index="14"> 21 B 01-10-2008 10,49,20 \\d- 13096\c$\tmuninst.ini 01-10-2009 Test Description RetInit:STARTED ObjHeld:NO</line>
<line index="15">Modified: 03-07-2008 13,45,52Created: 14-02-2008 04,26,38</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query archive -description="Test Description" - filelist=C:\filelist.txt -dateformat=2 -numberformat=2 -timeformat=2 - fromdate=30-09-2008 -fromtime=12,00,00 -todate=01-10-2008 - totime=16,00,00 -detail -filesonly</command>
<line-count>15</line-count>
<execution-milliseconds>1860</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: 01-10-2008 11,32,46</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: D-13096</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: 01-10-2008 11,30,49 Last access: 01- 10-2008 10,49,20</line>
<line index="10"> Size Archive Date - Time File - Expires on - Description</line>
<line index="11"> ---- ------------------- -------------- -----------------</line>
<line index="12"> 21 B 01-10-2008 10,49,17 \\d- 13096\c$\tmuninst.ini 01-10-2009 Test Description RetInit:STARTED ObjHeld:NO</line>
<line index="13">Modified: 03-07-2008 13,45,52Created: 14-02-2008 04,26,38</line>
<line index="14"> 21 B 01-10-2008 10,49,20 \\d- 13096\c$\tmuninst.ini 01-10-2009 Test Description RetInit:STARTED ObjHeld:NO</line>
<line index="15">Modified: 03-07-2008 13,45,52Created: 14-02-2008 04,26,38</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*