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
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. |