Query Filespace

The query filespace command displays a list of file spaces for a node. The file spaces are stored on the Tivoli® Storage Manager server, or inside a backup set from the Tivoli Storage Manager server when the backupsetname option is specified. You can also specify a single file space name to query.

A file space is a logical space on the server that contains files you backed up or archived. Tivoli Storage Manager assigns a separate file space on the server for each node at your workstation from which you back up or archive files.

Tivoli Storage Manager assigns a separate file space on the server for each file system at your workstation from which you back up or archive files. The file space name is the same as the file system name.

Windows operating systems A Unicode file space name might not display correctly if the server is unable to display the Unicode name. In this case, use the file space identifier (fsID) to identify these file spaces on the server. Use the query filespace command with the detail option to determine the fsID of a file space.

Supported Clients

This command is valid for all clients.

Syntax


>>-Query Filespace--+------------------+--+------------+-------><
                    '- --filespacename-'  '- --options-'

Parameters

filespacename: Specifies an optional character string that can include wildcards. Use this argument to specify a subset of file spaces. The default is to display all file spaces.

Table 1. Query Filespace command: Related options
Option	Where to use
backupsetname	Command line only.
class	Command line only.
dateformat	Client options file (dsm.opt) or command line.
dateformat	Client user-options file (dsm.opt) or command line.
detail	Command line only.
fromnode	Command line only.
fromowner	Command line only.
nasnodename	Client system options file (dsm.sys) or command line.
nasnodename	Client options file (dsm.opt) or command line.
scrolllines	Client options file (dsm.opt) or command line.
scrolllines	Client user-options file (dsm.opt) or command line.
scrollprompt	Client options file (dsm.opt) or command line.
scrollprompt	Client user-options file (dsm.opt) or command line.
timeformat	Client options file (dsm.opt) or command line.
timeformat	Client user-options file (dsm.opt) or command line.

Examples

Display your file spaces. Use the dateformat and timeformat options to reformat the dates and times.

query filespace –date=5 –time=4

Display the /home file space.

query filespace /home

Display file space names that include the pattern smith.

query filespace "*smith*"

Query a file space from the nas2 NAS file server.

query filespace -nasnodename=nas2 -class=nas

Display the \\florence\c$ file space.

query filespace \\florence\c$

Display all of the file space names on the server with a file space name that ends in '$' belonging to system named florence.

query filespace \\florence\*$

Display file spaces in the backup set named monthly_accounting.23456789.

query filespace -backupsetname=monthly_accounting.23456789

Display detailed file space information that shows the replication status during a failover.

Command:

query filespace -detail

Output:

#   Last Incr Date       Type   fsID  Unicode  Replication  File Space Name
---  --------------       ------ ----  -------  -----------  --------------
  1  00/00/0000 00:00:00  HFS       3  Yes      Current      /             

        Last Store Date     Server                  Local
        ---------------     ------                  -----
           Backup Data :    04/29/2013 16:49:55     04/29/2013 16:49:55     
          Archive Data :    No Date Available       No Date Available