Tivoli Header
Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide
The query backup command displays a list of backup versions of
your files. File information includes the file specification, size,
backup date, whether the file is active or inactive, and the management class
assigned to the file. Only the first ten characters of the management
class name are displayed.
You can use the query backup command to display information
about file system images backed up for a NAS file server.
Use the nasnodename option to identify the NAS file server to
query. When using an interactive command line session with a
non-administrative ID, Tivoli Storage Manager prompts for an administrator
ID. Place the nasnodename option in your client options file
dsm.opt. The value in the client options file is the
default, but this value can be overridden on the command line. See Nasnodename for more information.
Use the class option to specify the class of the file space to
query. To display a list of images belonging to a NAS node, use the
-class=nas option. Using the default,
-class=client, will not change the current query
backup behavior. See Class for more information.
Supported Clients
This command is valid for all Windows clients.
Syntax
>>-Query Backup--+----------+--+- filespec----------------+----><
'- options-' '- {filespacename}filespec-'
Parameters
- options
- You can use these command line options with the query backup
command: class, dirsonly, filelist, filesonly, fromdate, fromnode,
fromtime, pitdate, pittime, todate, totime. For more information,
see Chapter 10, "Using Options with Commands".
You can use these common options with the query backup
command: subdir, scrolllines,
nasnodename, scrollprompt. See Chapter 9, Setting Processing Options for information about these common
options.
- filespec
- Specifies the path and file name that you want to query. Use
wildcard characters to specify a group of files or all the files in a
directory. Do not use wild cards when you query NAS file system images
with -class=nas option.
- Note:
- If you include filespacename, do not include a drive letter
in the file specification. Drive label names are only used for
removable media.
- {filespacename}
- Specifies the file space (enclosed in braces) on the server that contains
the file you want to query. This is the drive label or UNC name on the
workstation drive from which the file was backed up. The following
example is valid for specifying a UNC name:
{'\\machine\C$'}.
Use the filespacename if the name has changed, or if you want to
query files backed up from another node with drive label names that are
different from yours.
- Note:
- You must specify a mixed or lowercase NTFS file space name enclosed in quotes
and braces. For example, {"NTFSDrive"}. Single quotes
or double quotes are valid in loop mode. For example:
{"NTFSDrive"} and {'NTFSDrive'} are both
valid. In batch mode, only single quotes are valid. The single
quotes requirement is a restriction of the operating system.
Examples
- Task
- Query files from the abc file space proj
directory.
Command: q b
{"abc"}\proj\*.*
- Task
- Display a list of all active and inactive backup versions that were backed
up from the c:\proj directory.
Command: q backup -ina c:\proj\*
- Task
- Display a list of all active and inactive backup versions that were backed
up from the c:\proj directory. Use the
dateformat and timeformat options to reformat the dates
and times.
Command: q b -date=5 -time=4 -ina
c:\proj\*
- Task
- Last week you backed up files from a diskette labeled
docs. Display a list of those files.
Command: q b {docs}\*
- Task
- Query file system images from the nas2 NAS file server.
Command: query backup -nasnodename=nas2
-class=nas
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]