Administrator's Reference

QUERY OCCUPANCY (Display File Space Information by Storage Pool)

Use the QUERY OCCUPANCY command to display information on where a client's file spaces are stored and how much space they occupy. This command can be used to display information about file spaces that are stored in primary or copy storage pools.

Privilege Class

Any administrator can issue this command.

Syntax

                     .-*--*-------------------------.
>>-Query OCCupancy---+------------------------------+----------->
                     |           .-*-------------.  |
                     '-nodename--+---------------+--'
                                 '-filespacename-'
 
>----+-----------------------+--+----------------------------+-->
     '-STGpool--=--poolname--'  '-DEVclass--=--devclassname--'
 
    .-Type--=--ANY----------.
>---+-----------------------+----------------------------------><
    '-Type--=--+-ANY-----+--'
               +-Backup--+
               +-Archive-+
               '-SPacem--'
 

Parameters

nodename

Specifies the name of the node that owns the file spaces that you want to locate. This parameter is optional. You can use a pattern-matching expression to specify this name. All matching names are included in the query. If you do not specify a value for this parameter, all nodes are queried.

filespacename

Specifies the name of the file space that you want to locate. This parameter is optional. You can use a pattern-matching expression to specify this name. All matching names are included in the query. If you do not specify a value for this parameter, all file spaces are queried. If you explicitly specify a file space name, you must also specify a node name.

STGpool=poolname

Specifies the name of the storage pool in which files from the specified file space are stored. This parameter is optional. You can use a pattern-matching expression to specify this name. All matching storage pools are included in the query. If you do not specify a value for this parameter, all storage pools are queried.

DEVclass=devclassname

Specifies the name of the device class to which the file spaces are assigned. This parameter is optional. You can use a pattern-matching expression to specify this name. All matching device classes are included in the query. If you do not specify a value for this parameter, all storage pools are queried.

Type=filetype

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 one or more client nodes.

Backup

Specifies that backup files are queried.

Archive

Specifies that archive files are queried.

SPacem

Specifies that space management files (files migrated from one or more client nodes) 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 where the file spaces that belong to the node WAYNE, and that have a backup file type, are stored.

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

Specifies the name of the node that owns the specified file space.

Type

Specifies the type of data. The possible values are:

Arch

Specifies that the data has been archived

Bkup

Specifies that the data has been backed up

Spmg

Specifies that the data has been space managed

Filespace Name

Specifies the name of the file space that belongs to the node. A name of archive indicates that the data was archived before collocation by filespace was added to ADSM.

Storage Pool Name

Specifies the name of the storage pool where the file space currently resides.

Number of Files

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

Physical Space Occupied (MB)

Specifies the amount of physical space occupied by the file space.

Logical Space Occupied (MB)

Specifies the amount of logical space occupied by the file space.

Related Commands

Table 148. Commands Related to QUERY OCCUPANCY

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