![]() |
![]() |
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.
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
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.
Use this parameter only when you enter a partly or fully qualified file space name. The default value is SERVER. Possible values are:
Examples
Task 1
Query all file spaces associated with all client nodes.
+--------------------------------------------------------------------------------+ |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.
+--------------------------------------------------------------------------------+ | 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:
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.
Related Commands
Table 187. 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. |