QUERY OCCUPANCY (Query client file spaces in storage pools)

Use this command to show 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---------.  .-NAMEType--=--SERVER------.   
>--+----------------------+--+--------------------------+------->
   '-Type--=--+-ANY-----+-'  '-NAMEType--=--+-SERVER--+-'   
              +-Backup--+                   +-UNIcode-+     
              +-Archive-+                   '-FSID----'     
              '-SPacem--'                                   

   .-CODEType--=--BOTH-----------.   
>--+-----------------------------+-----------------------------><
   '-CODEType--=--+-UNIcode----+-'   
                  +-NONUNIcode-+     
                  '-BOTH-------'

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.

For a server that has clients with Unicode support, you might need to have the server convert the file space name that you enter. For example, you might need to have the server convert the name that you enter from the server's code page to Unicode. See the NAMETYPE parameter for details. If you do not specify a file space name or specify only a single wildcard character for the name, you can use the CODETYPE parameter to limit the operation to Unicode file spaces or non-Unicode file spaces.

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 that is 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 that are 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: back up versions of files, archived copies of files, and files that are migrated from Tivoli® Storage Manager for Space Management clients.
Backup: Specifies that backup files are queried.
Archive: Specifies that archive files are queried.
SPacem: Specifies that space-managed files (files that were migrated by a Tivoli Storage Manager for Space Management client) are queried.

NAMEType

Specifies how you want the server to interpret the file space names that you enter. This parameter is useful when the server has clients with Unicode support. A backup-archive client with Unicode support is available only for Windows, Macintosh OS 9, Macintosh OS X, and NetWare. Use this parameter only when you specify a partly or fully qualified file space name.

The default value is SERVER. Possible values are:

SERVER: The server uses the server's code page to interpret the file space names.
UNIcode: The server converts the file space names from the server code page to the UTF-8 code page. The success of the conversion depends on the actual characters in the names and the server's code page. Conversion can fail if the string includes characters that are not available in the server code page, or if the server has a problem accessing system conversion routines.
FSID: The server interprets the file space names as their file space IDs (FSIDs).

CODEType

Specifies how you want the server to interpret the file space names that you enter. Use this parameter only when you enter a single wildcard character for the file space name or when you do not specify any file space name.

The default value is BOTH, which means that the file spaces are included regardless of code page type. Possible values are:

UNIcode: Include file spaces that are only Unicode enabled.
NONUNIcode: Include file spaces that are not only Unicode enabled.
BOTH: Include file spaces regardless of code page type.

Example: Display file spaces assigned to a specific node

Display information about where all file spaces assigned to the node named DAISY are stored. See Field descriptions for field descriptions.

query occupancy daisy

Node    Type  Filespace   FSID  Storage   Number   Physical   Logical
Name          Name              Pool      of       Space      Space
                                Name      Files    Occupied   Occupied
                                                   (MB)       (MB)
------- ----  ---------- -----  --------  -------- -------    --------
 DAISY  Bkup  DRIVED       1    COPYFILE     38     0.45       0.42

Example: Display file spaces assigned to a specific node with a backup file type

Display information about the file spaces that belong to the node WAYNE, and that have a backup file type. See Field descriptions for field descriptions.

query occupancy wayne type=backup

 Node   Type  Filespace FSID   Storage     Number  Physical   Logical
 Name         Name             Pool        of      Space      Space
                               Name        Files   Occupied   Occupied
                                                   (MB)       (MB)
 ------ ----- --------- -----  ----------- ------- ---------  --------
 WAYNE  Bkup  DWG1        1    BACKUPPOOL1 2,330   53.19      50.01
 WAYNE  Bkup  OS2C        2    BACKUPPOOL1 1,554   32.00      31.30

Field descriptions

Node Name

The node that owns the file space. If the node was previously deleted, the node name DELETED is displayed.

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 a Tivoli Storage Manager for Space Management client.

Filespace Name

The name of the file space that belongs to the node.

If the file space was previously deleted, the file space name DELETED is displayed.

File space names can be in a different code page or locale than the server. If they are, the names in the Operations Center and the administrative command-line interface might not be displayed correctly. Data is backed up and can be restored normally, but the file space name or file name might be displayed with a combination of invalid characters or blank spaces.

If the file space name is Unicode-enabled, Tivoli Storage Manager converts the name to the server code page for display. The success of the conversion depends on the operating system, the characters in the name, and the server code page. Conversion can be incomplete if the string includes characters that are not available in the server code page or if the server cannot access system conversion routines. If the conversion is incomplete, the name might contain question marks, blanks, unprintable characters, or ellipses (...).

Storage Pool Name

The storage pool where the file space is located.

Number of Files

The number of logical files that belong to the file space and are stored in this storage pool. When storing a file larger than 10 GB, the server splits the file into 10 GB fragments. The number of fragments is also included in this value for occupancy calculations.

Physical Space Occupied (MB)

The amount of physical space that is occupied by the file space. Physical space includes empty space within aggregates, from which files might have been deleted or expired. For this value, 1 MB = 1048576 bytes.

Tip: This field does not display a value for storage pools that are set up for data deduplication. If you turn off data deduplication for a storage pool, a value for physical occupancy is not displayed until the storage pool is empty of deduplicated files.

Logical Space Occupied (MB)

The amount of space that is occupied by logical files in the file space. Logical space is the space that is actually used to store files, excluding empty space within aggregates. For this value, 1 MB = 1048576 bytes.

FSID

The file space ID (FSID) for the file space. The server assigns a unique FSID when a file space is first stored on the server.

Related commands

Table 1. Commands related to QUERY OCCUPANCY
Command	Description
DELETE FILESPACE	Deletes data associated with client file spaces. If a file space is part of a collocation group and you remove the file space from a node, the file space is removed from the collocation group.
QUERY FILESPACE	Displays information about data in file spaces that belong to a client.
QUERY NODE	Displays partial or complete information about one or more clients.