Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Query Backup

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.

Querying NAS File System Images

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 ]