Tivoli Header
Administrator's Reference
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 198. 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 ]