Tivoli Storage Manager for Windows: Administrator's Reference
Use this command to display information about client node server storage
utilization. To display current license audit information from the
server, use the AUDIT LICENSE command prior to issuing the QUERY
AUDITOCCUPANCY command.
- Note:
- As part of a license audit operation, the server calculates, by node, the
amount of backup, archive, and space management storage in use. For
servers managing large amounts of data, this calculation can take a great deal
of CPU time and can stall other server activity. You can use the
AUDITSTORAGE server option to specify that storage is not to be calculated as
part of a license audit.
You can use the information from this query to determine if and where
client node storage utilization needs to be balanced. This information
can also assist you with billing clients for storage usage.
Privilege Class
Any administrator can issue this command.
Syntax
>>-Query AUDITOccupancy--+---------------+---------------------->
| .-,---------. |
| V | |
'---node_name-+-'
>--+----------------------------+------------------------------->
| .-,-----------. |
| V | |
'-DOmain--=----domain_name-+-'
.-POoltype--=--ANY---------.
>--+--------------------------+--------------------------------><
'-POoltype--=--+-ANY-----+-'
+-PRimary-+
'-COpy----'
Parameters
- node_name
- Specifies a list of nodes for which to display server storage use
information. Specify more than one node by separating the node names
with commas, with no intervening spaces. You can use wildcard
characters to specify names. The default (*) is to query all
client nodes. Use the DOMAIN parameter to limit this list by policy
domain. This parameter is optional.
- DOmain
- Specifies a list of policy domains to restrict which nodes are
displayed. Nodes belonging to the specified policy domains are
displayed. Specify more than one policy domain by separating the policy
domain names with commas, with no intervening spaces. You can use
wildcard characters to specify names. This parameter is
optional.
- POoltype
- Specifies the type of storage pool storage to display. This
parameter is optional. The default is ANY. Possible values
are:
- ANY
- Specifies both primary and copy storage pools. The value presented
is the total for the two pools.
- PRimary
- Specifies primary storage pools only.
- COpy
- Specifies copy storage pools only.
Examples
Task
Display combined storage use in primary and copy storage pools.
- Command:
- query auditoccupancy
- Output:
-
+--------------------------------------------------------------------------------+
|License information as of last audit on 05/22/1996 14:49:51. |
| |
|Client Node Name Backup Archive Space-Managed Total |
| Storage Storage Storage Used Storage |
| Used (MB) Used (MB) (MB) Used (MB) |
|--------------------- --------- ---------- ------------ --------- |
|CLIENT 245 20 0 265 |
|SMITH 245 20 0 265 |
|SMITHERS 245 20 0 265 |
|JOHNSON 300 15 0 320 |
|JOE 245 20 0 265 |
|TOM 300 15 0 320 |
|LARRY 245 20 0 265 |
+--------------------------------------------------------------------------------+
where:
- Client Node Name
- Specifies the name of the client node.
- Backup Storage Used (MB)
- Specifies, in megabytes, the total backup storage use for the node.
- Archive Storage Used (MB)
- Specifies, in megabytes, the total archive storage use for the
node.
- Space-Managed Storage Used (MB)
- Specifies, in megabytes, the amount of server storage used to store files
migrated from the client node.
- Total Storage Used (MB)
- Specifies, in megabytes, the total storage use for the node.
Related Commands
Table 166. Commands Related to QUERY AUDITOCCUPANCY
Command
| Description
|
AUDIT LICENSES
| Checks for compliance with defined licenses.
|
QUERY LICENSE
| Displays information about licenses and audits.
|
QUERY STATUS
| Displays the settings of server parameters, such as those selected by the
SET commands.
|
REGISTER LICENSE
| Registers a new license with the TSM server.
|
SET LICENSEAUDITPERIOD
| Specifies the number of days between automatic license audits.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]