Administrator's Reference

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 may need to have the server convert the file space name that you enter. For example, you may need to have the server convert the name 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 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.

NAMEType

Specify 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 currently available only for Windows NT, Windows 2000, Windows 2002, and Windows XP operating systems. 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

Specify 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 only file spaces that are Unicode enabled.

NONUNIcode

Include only file spaces that are not Unicode enabled.

BOTH

Include file spaces regardless of code page type.

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   FSID   Storage   Number   Physical   Logical        |
|                Name               Pool      of       Space      Space          |
|                                   Name      Files    Occupied   Occupied       |
|                                                      (MB)       (MB)           |
|--------- ----  ---------- ------  --------- -------- -------    --------       |
| DAISY    Bkup  DRIVED       1     COPYFILE     38     0.45       0.42          |
|                                                                                |
+--------------------------------------------------------------------------------+

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 FSID   Storage     Number  Physical   Logical        |
|                 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          |
|                                                                                |
+--------------------------------------------------------------------------------+

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 Tivoli Storage Manager product.

File space names and file names that can be in a different code page or locale than the server do not display correctly on the administrator's Web interface or the administrative command-line interface. The data itself is backed up and can be restored properly, but the file space or file name may display with a combination of invalid characters or blank spaces.

If the file space name is Unicode enabled, the name is converted to the server's code page for display. The results of the conversion for characters not supported by the current code page depends on the operating system. For names that Tivoli Storage Manager is able to partially convert, you may see question marks (??), blanks, unprintable characters, or "...". These characters indicate to the administrator that files do exist. If the conversion is not successful, the name is displayed as "...". 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.

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.

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 195. Commands Related to QUERY OCCUPANCY