Administrator's Reference
Use this command to display information on 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---------.
>-----+----------------------+---------------------------------><
'-Type--=--+-ANY-----+-'
+-Backup--+
+-Archive-+
'-SPacem--'
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.
- 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.
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 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 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
- 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 TSM product.
- 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.
Related Commands
Table 183. 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 ]