AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

Query Image

The query image command displays information about file system images that are stored on the Tivoli® Storage Manager server, or that are inside a backup set from the Tivoli Storage Manager server, when the backupsetname option is specified.

The following information about file system images is displayed:

Note: The Tivoli Storage Manager API must be installed to use the query image command.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

Supported Clients

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsThis command is valid for AIX®, HP-UX, all Linux clients, and Solaris.

Windows operating systemsThis command is valid for all Windows clients.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-Query IMage--+------------+--+- --logicalvolumename-+-------><
                '- --options-'  '- --filespacename-----'   

Parameters

logicalvolumename
The name of a logical volume you want to query. You must specify the exact name of the image. You cannot use wildcards. The default is all active images (unless restricted by one or more options).
filespacename
Specifies the file system name that you want to query.

Omitting logicalvolumename and filespacename causes all images to be displayed.

Table 1. Query Image command: Related options
Option Where to use
backupsetname Command line only.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsdateformat AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsClient user option file (dsm.opt) or command line.
Windows operating systemsdateformat Windows operating systemsClient option file (dsm.opt) or command line.
fromnode Command line only.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsfromowner AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsCommand line only.
inactive Command line only.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsnumberformat AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsClient user option file (dsm.opt) or command line.
Windows operating systemsnumberformat Windows operating systemsClient option file (dsm.opt) or command line.
pitdate Command line only.
pittime Command line only.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsscrolllines AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsClient user options file (dsm.opt) or command line.
Windows operating systemsscrolllines Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsscrollprompt AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris 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 systemstimeformat AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsClient user option file (dsm.opt) or command line.
Windows operating systemstimeformat Windows operating systemsClient option file (dsm.opt) or command line.

Examples

Task
Display all backed up images.

Command: q image

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsDisplay all backed up images that are owned by kutras at node avalon .

Command: query image -fromnode=avalon -fromowner=kutras

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsDisplay active and inactive version of the /usr image.

Command: q i /usr -inactive

Windows operating systemsTask
Windows operating systemsDisplay active and inactive version of the h: image.

Command: q im h: -inactive

Task
Display all images that are contained within the backup set weekly_backup_data.32145678.

Command: query image -backupsetname=weekly_backup_data.32145678