Query-access operation
The query-access operation displays a list of users to whom you have provided access to back up different versions or archive copies of the specific files.
The following table describes the elements for the query-access operation:
Adapter request elements for the query-access operation
The following figure shows a sample adapter request for the query-access operation:
Sample adapter request for the query-access operation
<tsm-request>
<operation-name>query-access</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
</command-request>
</tsm-request>
<operation-name>query-access</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the query-access operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query access</command>
<line-count>13</line-count>
<execution-milliseconds>1776</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: 11/20/08 18:47:43</line>
<line index = "5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index = "6">Node Name: SOL10</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: 11/20/08 18:42:39 Last access: 11/19/08 17:28:59</line>
<line index = "10">Type Node User Path</line>
<line index = "11">---- ----------------------------</line>
<line index = "12">Archive SOL111 * /test.txt</line>
<line index = "13">ANS1148I 'Query Access' command successfully completed</line>
</output>
</command-output>
</commands-output>
</tsm-response>{{</command-output>}}{{</commands-output>}}{{</tsm-response>}}
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc query access</command>
<line-count>13</line-count>
<execution-milliseconds>1776</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: 11/20/08 18:47:43</line>
<line index = "5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index = "6">Node Name: SOL10</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: 11/20/08 18:42:39 Last access: 11/19/08 17:28:59</line>
<line index = "10">Type Node User Path</line>
<line index = "11">---- ----------------------------</line>
<line index = "12">Archive SOL111 * /test.txt</line>
<line index = "13">ANS1148I 'Query Access' command successfully completed</line>
</output>
</command-output>
</commands-output>
</tsm-response>{{</command-output>}}{{</commands-output>}}{{</tsm-response>}}
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*