Query Backupset without the backupsetname parameter

The query backupset command can be used without the backupsetname parameter.

The preferred syntax for query backupset command requires the backupsetname parameter. Prior to the introduction of the backupsetname parameter, the Tivoli® Storage Manager client queried backup sets with a different syntax.

While you can use syntax from previous releases for this command, do not do so unless you have a specific need and cannot replace the old syntax with the syntax in Tivoli Storage Manager Version 6.1. For best results, use the backupsetname parameter.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systems

Supported Clients

This command is valid for all clients. Tape support is only available on AIX®, Solaris, and HP-UX.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-Query BACKUPSET--+---------+--+-backupsetname-+-------------->
                    '-options-'  +-localfilename-+   
                                 '-tapedevice----'   

>--+-----------------------+-----------------------------------><
   '-LOCation=--+-server-+-'   
                +-file---+     
                '-tape---'     

Parameters

backupsetname
Specifies the name of the backup set from the Tivoli Storage Manager server. If the location parameter is specified, you must set -location=server.
localfilename
Specifies the file name of the first backup set volume. You must set -location=file.
tapedevice
Specifies the name of the tape device containing the backup set volume. You must use a Windows native device driver, not the device driver provided by Tivoli. You must set -location=tape.
LOCation=
Specifies where Tivoli Storage Manager searches for the backup set. If you do not specify the location parameter, the client searches for backup sets on the Tivoli Storage Manager server.
server
Specifies that Tivoli Storage Manager searches for the backup set from the server. This is the default.
file
Specifies that Tivoli Storage Manager searches for the backup set from a local file.
tape
Specifies that Tivoli Storage Manager searches for the backup set from a local tape device.
Table 1. Query Backupset command: Related options
Option Where to use
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsdescription AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsCommand line only.
Windows operating systemsdescription Windows operating systemsCommand line only.
Windows operating systemsscrolllines Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsscrolllines AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient user-options file (dsm.opt) or command line.
Windows operating systemsscrollprompt Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsscrollprompt AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient user-options file (dsm.opt) or command line.

Examples

Task
Query all backup sets from the Tivoli Storage Manager server.

Command: query backupset

Task
Query a backup set called monthy_financial_data from the Tivoli Storage Manager server.

Command: query backupset monthly_financial_data.12345678

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsQuery the backup set in the file /home/budget/weekly_budget_data.ost.

Command: dsmc query backupset /home/budget/weekly_budget_data.ost -loc=file

Windows operating systemsTask
Windows operating systemsQuery the backup set in the filec:\budget\weekly_budget_data.ost.

Command: query backupset c:\budget\weekly_budget_data.ost loc=file

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsQuery the backup set from the /dev/rmt0 tape device.

Command: dsmc query backupset /dev/rmt0 -loc=tape

Windows operating systemsTask
Windows operating systemsQuery the backup set from the \\.\tape0 tape device.

Command: dsmc query backupset \\.\tape0 -loc=tape