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-----.  .-NAMEType--=--SERVER------.
>--+-------------------------+--+--------------------------+---->
   '-Format--=--+-Standard-+-'  '-NAMEType--=--+-SERVER--+-'
                '-Detailed-'                   +-UNIcode-+
                                               '-FSID----'
 
   .-CODEType--=--BOTH-----------.
>--+-----------------------------+-----------------------------><
   '-CODEType--=--+-UNIcode----+-'
                  +-NONUNIcode-+
                  '-BOTH-------'
 
 

Parameters

node_name
Specifies the client node to which the file space belongs. You can use wildcard characters to specify this name. This parameter is optional. The default is all client node 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. You can use wildcard characters to specify this name. This parameter is optional. If a value is not specified, all file spaces are queried.

For a server that has clients with support for Unicode-enabled file spaces, 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 to non-Unicode file spaces.

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.

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 support for Unicode. A backup-archive client with support for Unicode is currently available only for Windows NT and Windows 2000 operating systems.

Use this parameter only when you enter 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 name entered from the server code page to the UTF-8 code page. The success of the conversion depends on the actual characters in the name 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 what type of file spaces are to be included in the operation. The default is BOTH, meaning that file spaces are included regardless of code page type. Use this parameter only when you enter a single wildcard character for the file space name. Possible values are:

UNIcode
Include only file spaces that are in Unicode.

NONUNIcode
Include only file spaces that are not in Unicode.

BOTH
Include file spaces regardless of code page type.

Examples

Task 1

Query all file spaces associated with all client nodes.

Command:
query filespace

Output:
 
+--------------------------------------------------------------------------------+
|Node Name  Filespace   FSID  Platform  Filespace    Is     Capacity   Pct       |
|           Name                        Type      Filespace     (MB)  Util       |
|                                                 Unicode?                       |
|---------- ----------- ----  -------  --------- --------- -------- -----        |
|JOE        \\joe\c$       1  WinNT     NTFS        Yes     2,502.3  75.2        |
|JOE        \\joe\d$       2  WinNT     NTFS        Yes     6,173.4  59.6        |
|                                                                                |
+--------------------------------------------------------------------------------+

Task 2

Display detailed information on the \\joe\c$ file space that belongs to the client node JOE.

Command:
query filespace joe \\joe\c$ nametype=unicode format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|                       Node Name: JOE                                           |
|                  Filespace Name: \\joe\c$                                      |
|      Hexadecimal Filespace Name: 5c5c6a6f655c6324                              |
|                            FSID: 1                                             |
|                        Platform: WinNT                                         |
|                  Filespace Type: NTFS                                          |
|           Is Filespace Unicode?: Yes                                           |
|                   Capacity (MB): 2,502.3                                       |
|                        Pct Util: 75.2                                          |
|     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.

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

Hexadecimal Filespace Name
Specifies the hexadecimal name of the file space for the client node in UTF-8 format.

FSID
Specifies the file space ID of the file space.

Platform
Specifies the platform for the client node.

Filespace Type
Specifies the type of file space.

Is Filespace Unicode?
Indicates whether the file space is Unicode.

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