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 backup-archive 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 6.1. For best results, use the backupsetname parameter.

Windows operating systemsLinux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systems

Supported Clients

This command is valid for all clients.

Oracle Solaris operating
systemsAIX operating systemsTape support is only available on AIX® and Oracle Solaris clients.

Syntax

Read syntax diagramSkip visual syntax diagramQuery BACKUPSEToptionsbackupsetnamelocalfilenametapedeviceLOCation=serverfiletape

Parameters

backupsetname
Specifies the name of the backup set from the IBM® Storage Protect 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 IBM. You must set -location=tape.
LOCation=
Specifies where the client searches for the backup set. If you do not specify the location parameter, the client searches for backup sets on the IBM Storage Protect server.
server
Specifies that the client searches for the backup set from the server. This is the default.
file
Specifies that the client searches for the backup set from a local file.
tape
Specifies that the client searches for the backup set from a local tape device.
Table 1. Query Backupset command: Related options
Option Where to use
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsdescription Linux operating systemsOracle Solaris operating
systemsAIX 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsscrolllines Linux operating systemsOracle Solaris operating
systemsAIX 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsscrollprompt Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsClient user-options file (dsm.opt) or command line.

Examples

Task
Query all backup sets from the IBM Storage Protect server.

Command: query backupset

Task
Query a backup set called monthy_financial_data from the IBM Storage Protect server.

Command: query backupset monthly_financial_data.12345678

Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsTask
Linux operating systemsOracle Solaris operating
systemsAIX 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

Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsTask
Linux operating systemsOracle Solaris operating
systemsAIX 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