Tivoli Storage Manager for Windows Administrator's Reference

QUERY OCCUPANCY (Query Client File Spaces in Storage Pools)

Use this command to display information on where client file spaces are stored and how much space they occupy.

Privilege Class

Any administrator can issue this command.

Syntax

                      .-*--*---------------------------.
>>-Query OCCupancy----+--------------------------------+-------->
                      |            .-*---------------. |
                      '-node_name--+-----------------+-'
                                   '-file_space_name-'
 
>-----+------------------------+-------------------------------->
      '-STGpool--=--pool_name--'
 
>-----+---------------------------------+----------------------->
      '-DEVclass--=--device_class_name--'
 
      .-Type--=--ANY---------.
>-----+----------------------+---------------------------------><
      '-Type--=--+-ANY-----+-'
                 +-Backup--+
                 +-Archive-+
                 '-SPacem--'
 

Parameters

node_name
Specifies the node that owns the file spaces that you want to locate. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a value for this parameter, all nodes are queried.

file_space_name
Specifies the file space that you want to locate. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a value for this parameter, all file spaces are queried. You must specify a node name if you specify a file space name.

STGpool
Specifies the storage pool to query for files from the specified file space. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a value for this parameter, all storage pools are queried.

DEVclass
Specifies the device class associated with the devices where the file spaces are stored. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a value for this parameter, storage pools associated with any device class are queried.

Type
Specifies the types of files to query in the file spaces. This parameter is optional. The default value is ANY. Possible values are:

ANY
Specifies that all types of files are queried: backup versions of files, archived copies of files, and files migrated from HSM clients.

Backup
Specifies that backup files are queried.

Archive
Specifies that archive files are queried.

SPacem
Specifies that space-managed files (files migrated from HSM clients) are queried.

Examples

Task 1

Display information on where all file spaces assigned to the node named DAISY are stored.

Command:
query occupancy daisy

Output:
 
+--------------------------------------------------------------------------------+
|Node Name Type  Filespace  Storage   Number   Physical   Logical                |
|                Name       Pool      of       Space      Space                  |
|                           Name      Files    Occupied   Occupied               |
|                                              (MB)       (MB)                   |
|--------- ----  ---------- --------- -------- -------    --------               |
| DAISY    Bkup  DRIVED     COPYFILE     38     0.45       0.42                  |
| DAISY    Bkup  DRIVED     YESBACK      38     0.45       0.43                  |
| DAISY    Bkup  DRIVE_F_N: COPYFILE      7     0.16       0.13                  |
| DAISY    Bkup  DRIVE_F_N: YESBACK       7     0.16       0.12                  |
| DAISY    Bkup  DRIVE_G_S: YESBACK      16     0.03       0.02                  |
| DAISY    Arch  (archive)  YESARCH      14     0.02       0.01                  |
| DAISY    Arch  DRIVE_F_N: YESARCH       6     0.02       0.01                  |
| DAISY    Arch  OS2        YESARCH      65     0.58       0.23                  |
| DAISY    Arch  DRIVE_G_S: YESARCH      14     0.02       0.01                  |
+--------------------------------------------------------------------------------+

See Task 2 for parameter definitions.

Task 2

Display information on the file spaces that belong to the node WAYNE, and that have a backup file type.

Command:
query occupancy wayne type=backup

Output:
 
+--------------------------------------------------------------------------------+
| Node Name Type  Filespace Storage     Number  Physical   Logical               |
|                 Name      Pool        of      Space      Space                 |
|                           Name        Files   Occupied   Occupied              |
|                                               (MB)       (MB)                  |
| --------- ----- --------- ----------- ------- ---------  --------              |
| WAYNE     Bkup  DWG1      BACKUPPOOL1 2,330    53.19       50.01               |
| WAYNE     Bkup  OS2C      BACKUPPOOL1 1,554    32.00       31.30               |
| WAYNE     Bkup  OS2D      BACKUPPOOL1 1,716    35.30       34.40               |
+--------------------------------------------------------------------------------+

where:

Node Name
The node that owns the file space.

Type
The type of data. Possible values are:

Arch
Data that has been archived

Bkup
Data that has been backed up

Spmg
Data that has been migrated from an HSM client (space-managed files)

Filespace Name
The name of the file space that belongs to the node. Where the name of the file space is (archive), that data was archived before collocation by file space was added to the TSM product.

Storage Pool Name
The storage pool where the file space currently resides.

Number of Files
The number of logical files that belong to the file space and are stored in this storage pool.

Physical Space Occupied (MB)
The amount of physical space occupied by the file space. Physical space includes empty space within aggregate files, from which files may have been deleted or expired.

Logical Space Occupied (MB)
The amount of space occupied by logical files in the file space. Logical space is the space actually used to store files, excluding empty space within aggregates.

Related Commands

Table 185. Commands Related to QUERY OCCUPANCY

Command Description
DELETE FILESPACE Deletes data associated with client's filespaces.
QUERY FILESPACE Displays information about data in filespaces that belong to a client.
QUERY NODE Displays partial or complete information about one or more clients.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]