Tivoli Storage Manager for HP-UX Administrator's Reference

QUERY AUDITOCCUPANCY (Query Client Node Storage Utilization)

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 147. 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 ]