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 before you issue the QUERY AUDITOCCUPANCY command.

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 that manage large amounts of data, this calculation can take a great deal of processor 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 must 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 to display. This parameter is optional. The default is ANY. Possible values are:

ANY: Specifies both primary and copy storage pools. The value that is presented is the total for the two pools.
PRimary: Specifies primary storage pools only.
COpy: Specifies copy storage pools only.

Example: Display storage usage

Display combined storage use in primary and copy storage pools. Issue the command:

query auditoccupancy

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

See Field descriptions for field descriptions.

Field descriptions

Client Node Name: Specifies the name of the client node.
Backup Storage Used (MB): Specifies the total backup storage use for the node. For this value, one MB = 1048576 bytes.
Archive Storage Used (MB): Specifies the total archive storage use for the node. For this value, one MB = 1048576 bytes.
Space-Managed Storage Used (MB): Specifies the amount of server storage that is used to store files that are migrated from the client node by a Tivoli® Storage Manager for Space Management client. For this value, one MB = 1048576 bytes.
Total Storage Used (MB): Specifies the total storage use for the node. For this value, one MB = 1048576 bytes.

Related commands

Table 1. Commands related to QUERY AUDITOCCUPANCY
Command	Description
AUDIT LICENSES	Verifies 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 license with the Tivoli Storage Manager server.
SET LICENSEAUDITPERIOD	Specifies the number of days between automatic license audits.