Administrator's Reference

QUERY FILESPACE (Query One or More File Spaces)

Use the QUERY FILESPACE command to display information about one or more file spaces that belong to a client node. The information displayed via the QUERY FILESPACE command reflects data as of the last incremental backup.

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.

Privilege Class

Any administrator can issue this command.

Syntax

                     .-*--*-------------------------.
>>-Query FIlespace---+------------------------------+----------->
                     |           .-*-------------.  |
                     '-nodename--+---------------+--'
                                 '-filespacename-'
 
     .-Format--=--Standard------.
>----+--------------------------+------------------------------><
     '-Format--=--+-Standard-+--'
                  '-Detailed-'
 

Parameters

nodename

Specifies the name of the client node to which the file space belongs. This parameter is optional. You can use a pattern-matching expression to specify this name. All matching client node names are included. If you do not specify a value for this parameter, all client nodes are queried.

You must specify a value for this parameter if you specify FILESPACENAME.

filespacename

Specifies the name of the file space to be queried. This parameter is optional. You can use a pattern-matching expression to specify this name. All matching file spaces are displayed. If you do not specify a value for this parameter, all file spaces are queried.

Format=formatvalue

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  %Util                  |
|             Name                   Type           (MB)                         |
|-----------  -----------  --------  ---------  --------  -----                  |
|JOEOS2       OS2          OS/2      HPFS           58.0   32.0                  |
|JOEOS2       D_DRIVE      OS/2      HPFS           57.0   30.8                  |
+--------------------------------------------------------------------------------+

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. The type is set by the client.

Capacity (MB)

Specifies the amount of space assigned to this file space, in megabytes, on the client node. This value applies to the actual file systems and media on the client node's machine.

%Util

Specifies, as a percentage of the capacity of the file space, the amount of occupied space in the file space, on the client node. This value applies to the actual file systems and media on the client node's machine.

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                                          |
|                           %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. The type is set by the client.

Capacity (MB)

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

%Util

Specifies, as a percentage of the capacity for the file space, the amount space that is occupied in the file space on the client node.

Last Backup Start Date/Time

Specifies the date and time that the last increment backup of the file space was initiated.

Days Since Last Backup Started

Specifies the number of days since the last increment backup of the file space was initiated.

Last Backup Completion Date/Time

Specifies the completion date and time of the last increment backup of the file space.

Days Since Last Backup Completed

Specifies the number of days since the last increment backup of the file space completed.

Related Commands

Table 137. Commands Related to QUERY FILESPACE

Command	Description
DELETE FILESPACE	Deletes data associated with one or more 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.