Expire operation
The expire operation deactivates the backup objects that you specify in the file specification or with the <filelist> element.
The following table describes the elements for the adapter request:
Adapter request elements for the expire operation
The following figure shows a sample adapter request for the expire operation:
Sample adapter request for the expire operation
<tsm-request>
<operation-name>expire</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<dateformat>DD-MM-YYYY</dateformat>
<timeformat>HH:MM:SS</timeformat>
<numberformat>d,ddd.dd</numberformat>
<noprompt />
</command-options>
<command-arguments>
<filespec>C:\YServer.txt</filespec>
</command-arguments>
</command-request>
</tsm-request>
<operation-name>expire</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<dateformat>DD-MM-YYYY</dateformat>
<timeformat>HH:MM:SS</timeformat>
<numberformat>d,ddd.dd</numberformat>
<noprompt />
</command-options>
<command-arguments>
<filespec>C:\YServer.txt</filespec>
</command-arguments>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the expire operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc expire -dateformat=2 -timeformat=1 -numberformat=1 - noprompt C:\YServer.txt</command>
<line-count>25</line-count>
<execution-milliseconds>4937</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 10:51:44</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 10:51:44 Last access: 10- 10-2008 10:50:29</line>
<line index="10">Expire function invoked.</line>
<line index="11">Expiring--> 146 \\l- 16862\c$\YServer.txt [Sent] </line>
<line index="12">Total number of objects inspected: 1</line>
<line index="13">Total number of objects backed up: 0</line>
<line index="14">Total number of objects updated: 0</line>
<line index="15">Total number of objects rebound: 0</line>
<line index="16">Total number of objects deleted: 0</line>
<line index="17">Total number of objects expired: 1</line>
<line index="18">Total number of objects failed: 0</line>
<line index="19">Total number of bytes transferred: 0 B</line>
<line index="20">Data transfer time: 0.00 sec</line>
<line index="21">Network data transfer rate: 0.00 KB/sec</line>
<line index="22">Aggregate data transfer rate: 0.00 KB/sec</line>
<line index="23">Objects compressed by: 0%</line>
<line index="24">Elapsed processing time: 00:00:03</line>
<line index="25">Expire processing of 'C:\YServer.txt' finished without failure.</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc expire -dateformat=2 -timeformat=1 -numberformat=1 - noprompt C:\YServer.txt</command>
<line-count>25</line-count>
<execution-milliseconds>4937</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 10:51:44</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 10:51:44 Last access: 10- 10-2008 10:50:29</line>
<line index="10">Expire function invoked.</line>
<line index="11">Expiring--> 146 \\l- 16862\c$\YServer.txt [Sent] </line>
<line index="12">Total number of objects inspected: 1</line>
<line index="13">Total number of objects backed up: 0</line>
<line index="14">Total number of objects updated: 0</line>
<line index="15">Total number of objects rebound: 0</line>
<line index="16">Total number of objects deleted: 0</line>
<line index="17">Total number of objects expired: 1</line>
<line index="18">Total number of objects failed: 0</line>
<line index="19">Total number of bytes transferred: 0 B</line>
<line index="20">Data transfer time: 0.00 sec</line>
<line index="21">Network data transfer rate: 0.00 KB/sec</line>
<line index="22">Aggregate data transfer rate: 0.00 KB/sec</line>
<line index="23">Objects compressed by: 0%</line>
<line index="24">Elapsed processing time: 00:00:03</line>
<line index="25">Expire processing of 'C:\YServer.txt' finished without failure.</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*