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.
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
- 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 an IBM Spectrum Protect™ 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
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 IBM Spectrum Protect server. |
SET LICENSEAUDITPERIOD | Specifies the number of days between automatic license audits. |