Tivoli Storage Manager for Windows Administrator's Reference

QUERY FILESPACE (Query One or More File Spaces)

Use this command to display information about file spaces that belong to a client node. The information displayed reflects data as of the last incremental backup.

Note:When a node has more than one file space, and a DELETE FILESPACE command is issued for only one file space, a QUERY FILESPACE command for the node during the delete process shows no file spaces. When the delete process ends, the remaining file spaces can be viewed with the QUERY FILESPACE command.

Privilege Class

Any administrator can issue this command.

Syntax

                      .-*--*---------------------------.
>>-Query FIlespace----+--------------------------------+-------->
                      |            .-*---------------. |
                      '-node_name--+-----------------+-'
                                   '-file_space_name-'
 
      .-Format--=--Standard-----.
>-----+-------------------------+------------------------------><
      '-Format--=--+-Standard-+-'
                   '-Detailed-'
 

Parameters

node_name
Specifies the client node to which the file space belongs. Use wildcard characters to specify this name. This parameter is optional. The default is all client nodes names. You must specify a value for this parameter if you specify a file name.

file_space_name
Specifies the name of the file space to be queried. Use wildcard characters to specify this name. This parameter is optional. If a value is not specified, all file spaces are queried.

File space names are case-sensitive. You can use the QUERY FILESPACE command to determine the correct capitalization for the file space to be queried.

Format
Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. Possible values are:

Standard
Specifies that partial information is displayed for the specified file space.

Detailed
Specifies that complete information is displayed for the specified file space.

Examples

Task 1

Query all file spaces associated with all client nodes.

Command:
query filespace

Output:
 

+--------------------------------------------------------------------------------+
|Node Name    Filespace    Platform  Filespace  Capacity  Pct Util               |
|             Name                   Type           (MB)                         |
|-----------  -----------  --------  ---------  --------  -----                  |
|JOEOS2       OS2          OS/2      HPFS           58.0   32.0                  |
|JOEOS2       D_DRIVE      OS/2      HPFS           57.0   30.8                  |
+--------------------------------------------------------------------------------+

Task 2

Display detailed information on the OS2 file space that belongs to the client node JOEOS2.

Command:
query filespace joeos2 OS2 format=detailed

Output:

+--------------------------------------------------------------------------------+
|                       Node Name: JOEOS2                                        |
|                  Filespace Name: OS2                                           |
|                        Platform: OS/2                                          |
|                  Filespace Type: HPFS                                          |
|                   Capacity (MB): 58.0                                          |
|                        Pct Util: 99.7                                          |
|     Last Backup Start Date/Time:                                               |
|  Days Since Last Backup Started:                                               |
|Last Backup Completion Date/Time:                                               |
|Days Since Last Backup Completed:                                               |
+--------------------------------------------------------------------------------+

where:

Node Name
Specifies the name of the client node.

Filespace Name
Specifies the name of the file space for the client node.

Platform
Specifies the platform for the client node.

Filespace Type
Specifies the type of file space.

Capacity (MB)
Specifies the amount of space, in megabytes, assigned to this file space on the client node.

Pct Util
Specifies the percentage of the file space that is occupied.

Last Backup Start Date/Time
Specifies the start date and time of the last incremental backup of the file space.

Days Since Last Backup Started
Specifies the number of days since the start of the last incremental backup of the file space.

Last Backup Completion Date/Time
Specifies the completion date and time of the last incremental backup of the file space.

Days Since Last Backup Completed
Specifies the number of days since the completion of the last incremental backup of the file space.

Related Commands

Table 174. Commands Related to QUERY FILESPACE

Command Description
DELETE FILESPACE Deletes data associated with client's filespaces.
REGISTER NODE Defines a client to the server and sets options for that user.
REMOVE NODE Removes a client from the list of registered nodes for a specific policy domain.
RENAME FILESPACE Renames a client filespace on the server.
UPDATE NODE Changes the attributes associated with a client node.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]