Archive operation
The archive operation archives a single file, selected files, or all the files in a directory, and its subdirectories, on a server.
The following figure describes the elements for the archive operation:
Adapter request elements for the archive operation
The following figure shows a sample adapter request for the archive operation:
Sample adapter request for the archive operation
<tsm-request>
<operation-name>archive</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<archmc>standard</archmc>
<changingretries>3</changingretries>
<compressalways>no</compressalways>
<compression>yes</compression>
<description>"Test Description"</description>
<filesonly />
<preservelastaccessdate>yes</preservelastaccessdate>
<skipntpermissions>yes</skipntpermissions>
<skipntsecuritycrc>yes</skipntsecuritycrc>
<v2archive />
</command-options>
<command-arguments>
<filespec>C:\tmuninst.ini</filespec>
</command-arguments>
</command-request>
<command-request>
<command-options>
<archmc>default</archmc>
<changingretries>3</changingretries>
<compressalways>no</compressalways>
<compression>yes</compression>
<description>"Test Description"</description>
<filesonly />
<preservelastaccessdate>yes</preservelastaccessdate>
<skipntpermissions>yes</skipntpermissions>
<skipntsecuritycrc>yes</skipntsecuritycrc>
<v2archive />
</command-options>
<command-arguments>
<filespec>C:\tmuninst.ini</filespec>
</command-arguments>
</command-request>
</tsm-request>
<operation-name>archive</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<archmc>standard</archmc>
<changingretries>3</changingretries>
<compressalways>no</compressalways>
<compression>yes</compression>
<description>"Test Description"</description>
<filesonly />
<preservelastaccessdate>yes</preservelastaccessdate>
<skipntpermissions>yes</skipntpermissions>
<skipntsecuritycrc>yes</skipntsecuritycrc>
<v2archive />
</command-options>
<command-arguments>
<filespec>C:\tmuninst.ini</filespec>
</command-arguments>
</command-request>
<command-request>
<command-options>
<archmc>default</archmc>
<changingretries>3</changingretries>
<compressalways>no</compressalways>
<compression>yes</compression>
<description>"Test Description"</description>
<filesonly />
<preservelastaccessdate>yes</preservelastaccessdate>
<skipntpermissions>yes</skipntpermissions>
<skipntsecuritycrc>yes</skipntsecuritycrc>
<v2archive />
</command-options>
<command-arguments>
<filespec>C:\tmuninst.ini</filespec>
</command-arguments>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the archive operation
<tsm-response>
<metadata>
<status>success</status>
<count>2</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc archive -archmc=standard -changingretries=3 - compressarchive C:\tmuninst.ini</command>
<line-count>25</line-count>
<execution-milliseconds>2765</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/01/2008 09:54:57</line>
<line index="5">(c) Copyright by IBM Corporation and other(s)</line>
<line index="6">Archive function invoked.</line>
<line index="7">Node Name: D-13096</line>
<line index="8">Session established with server </line>
<line index="9"> Server Version 5, Release 5, Level 0.0</line>
<line index="10"> Server date/time: 10/01/2008 09:53:00 </line>
<line index="11">Normal File--> [Sent] </line>
<line index="12">Archive processing of '\tmuninst.ini' finished </line>
<line index="13">Total number of objects inspected: 1</line>
<line index="14">Total number of objects archived: 1</line>
<line index="15">Total number of objects updated: 0</line>
<line index="16">Total number of objects rebound: 0</line>
<line index="17">Total number of objects deleted: 0</line>
<line index="18">Total number of objects expired: 0</line>
<line index="19">Total number of objects failed: 0</line>
<line index="20">Total number of bytes transferred: 45 B</line>
<line index="21">Data transfer time: 0.00 sec</line>
<line index="22">Network data transfer rate: 0.00 KB/sec</line>
<line index="23">Aggregate data transfer rate: 0.04 KB/sec</line>
<line index="24">Objects compressed by: 0%</line>
<line index="25">Elapsed processing time: 00:00:01</line>
</output>
</command-output>
<command-output>
<metadata>
<command>dsmc archive -archmc=default C:\tmuninst.ini</command>
<line-count>25</line-count>
<execution-milliseconds>2796</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/01/2008 09:55:00</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Archive function invoked.</line>
<line index="7">Node Name: D-13096</line>
<line index="8">Session established with server SERVER1: Linux/i386</line>
<line index="9"> Server Version 5, Release 5, Level 0.0</line>
<line index="10"> Server date/time: 10/01/2008 09:53:03 Last access: 10/01/2008 09:53:01</line>
<line index="11">Normal File--> 21 \\d- 13096\c$\tmuninst.ini [Sent] </line>
<line index="12">Archive processing of '\\d-13096\c$\tmuninst.ini' finished without failure.</line>
<line index="13">Total number of objects inspected: 1</line>
<line index="14">Total number of objects archived: 1</line>
<line index="15">Total number of objects updated: 0</line>
<line index="16">Total number of objects rebound: 0</line>
<line index="17">Total number of objects deleted: 0</line>
<line index="18">Total number of objects expired: 0</line>
<line index="19">Total number of objects failed: 0</line>
<line index="20">Total number of bytes transferred: 45 B</line>
<line index="21">Data transfer time: 0.00 sec</line>
<line index="22">Network data transfer rate: 0.00 KB/sec</line>
<line index="23">Aggregate data transfer rate: 0.04 KB/sec</line>
<line index="24">Objects compressed by: 0%</line>
<line index="25">Elapsed processing time: 00:00:01</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>2</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc archive -archmc=standard -changingretries=3 - compressarchive C:\tmuninst.ini</command>
<line-count>25</line-count>
<execution-milliseconds>2765</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/01/2008 09:54:57</line>
<line index="5">(c) Copyright by IBM Corporation and other(s)</line>
<line index="6">Archive function invoked.</line>
<line index="7">Node Name: D-13096</line>
<line index="8">Session established with server </line>
<line index="9"> Server Version 5, Release 5, Level 0.0</line>
<line index="10"> Server date/time: 10/01/2008 09:53:00 </line>
<line index="11">Normal File--> [Sent] </line>
<line index="12">Archive processing of '\tmuninst.ini' finished </line>
<line index="13">Total number of objects inspected: 1</line>
<line index="14">Total number of objects archived: 1</line>
<line index="15">Total number of objects updated: 0</line>
<line index="16">Total number of objects rebound: 0</line>
<line index="17">Total number of objects deleted: 0</line>
<line index="18">Total number of objects expired: 0</line>
<line index="19">Total number of objects failed: 0</line>
<line index="20">Total number of bytes transferred: 45 B</line>
<line index="21">Data transfer time: 0.00 sec</line>
<line index="22">Network data transfer rate: 0.00 KB/sec</line>
<line index="23">Aggregate data transfer rate: 0.04 KB/sec</line>
<line index="24">Objects compressed by: 0%</line>
<line index="25">Elapsed processing time: 00:00:01</line>
</output>
</command-output>
<command-output>
<metadata>
<command>dsmc archive -archmc=default C:\tmuninst.ini</command>
<line-count>25</line-count>
<execution-milliseconds>2796</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/01/2008 09:55:00</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Archive function invoked.</line>
<line index="7">Node Name: D-13096</line>
<line index="8">Session established with server SERVER1: Linux/i386</line>
<line index="9"> Server Version 5, Release 5, Level 0.0</line>
<line index="10"> Server date/time: 10/01/2008 09:53:03 Last access: 10/01/2008 09:53:01</line>
<line index="11">Normal File--> 21 \\d- 13096\c$\tmuninst.ini [Sent] </line>
<line index="12">Archive processing of '\\d-13096\c$\tmuninst.ini' finished without failure.</line>
<line index="13">Total number of objects inspected: 1</line>
<line index="14">Total number of objects archived: 1</line>
<line index="15">Total number of objects updated: 0</line>
<line index="16">Total number of objects rebound: 0</line>
<line index="17">Total number of objects deleted: 0</line>
<line index="18">Total number of objects expired: 0</line>
<line index="19">Total number of objects failed: 0</line>
<line index="20">Total number of bytes transferred: 45 B</line>
<line index="21">Data transfer time: 0.00 sec</line>
<line index="22">Network data transfer rate: 0.00 KB/sec</line>
<line index="23">Aggregate data transfer rate: 0.04 KB/sec</line>
<line index="24">Objects compressed by: 0%</line>
<line index="25">Elapsed processing time: 00:00:01</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*