Set-archive-access operation
The set-archive-access operation provides users at other nodes access to your archived copies of files or images. You can provide access to a specific file or image, multiple files or images, or all the files in a directory. When you provide access to another user, that user can restore or retrieve your objects.
The following table describes the request elements for the set-archive-access operation:
Adapter request elements for the set-archive-access operation
The following figure shows a sample adapter request for the set-archive-access operation:
Sample adapter request for the set-archive-access operation
<tsm-request>
<operation-name>set-archive-access</operation-name>
<command-request>
<command-arguments>
<filespec>C:\YServer.txt</filespec>
<nodename>l-16862</nodename>
</command-arguments>
</command-request>
</tsm-request>
<operation-name>set-archive-access</operation-name>
<command-request>
<command-arguments>
<filespec>C:\YServer.txt</filespec>
<nodename>l-16862</nodename>
</command-arguments>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the set-archive-access operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc set access archive C:\YServer.txt l-16862</command>
<line-count>10</line-count>
<execution-milliseconds>1437</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/11/2008 08:40:24</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/11/2008 08:40:24 Last access: 10/11/2008 08:40:11</line>
<line index="10">ANS1148I 'Set Access' command successfully completed</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc set access archive C:\YServer.txt l-16862</command>
<line-count>10</line-count>
<execution-milliseconds>1437</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/11/2008 08:40:24</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/11/2008 08:40:24 Last access: 10/11/2008 08:40:11</line>
<line index="10">ANS1148I 'Set Access' command successfully completed</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*