AIX 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 IBM Spectrum Protect™ server, or that are inside a backup set from the IBM Spectrum Protect server, when the backupsetname option is specified.

The following information about file system images is displayed:

  • Image Size - The volume size which was backed up.
  • AIX operating systemsLinux operating systemsOracle Solaris operating systemsStored Size - The actual image size that is stored on the server. The stored image on the IBM Spectrum Protect server is the same size as the volume capacity. For online snapshot-based image backups, the stored image can be larger than the file system based on the size of the cache files. The stored image on the server is the same size as the volume capacity.
  • Windows operating systemsStored Size - The actual image size that is stored on the server. Because image backup allows you to back up only used blocks in a file system, the stored image size on the IBM Spectrum Protect server could be smaller than the volume size. For online image backups, the stored image can be larger than the file system based on the size of the cache files.
  • File system type
  • Backup date and time
  • Management class that is assigned to image backup
  • Whether the image backup is an active or inactive copy
  • The image name
Note: The IBM Spectrum Protect API must be installed to use the query image command.

Supported Clients

AIX operating systemsLinux operating systemsOracle Solaris operating systemsThis option is valid for AIX®, Linux, and Oracle Solaris clients.

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 systemsLinux operating systemsOracle Solaris operating systemsdateformat AIX 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 systemsLinux operating systemsOracle Solaris operating systemsfromowner AIX operating systemsLinux operating systemsOracle Solaris operating systemsCommand line only.
inactive Command line only.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsnumberformat AIX 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 systemsLinux operating systemsOracle Solaris operating systemsscrolllines AIX 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 systemsLinux operating systemsOracle Solaris operating systemsscrollprompt AIX 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 systemsLinux operating systemsOracle Solaris operating systemstimeformat AIX 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 systemsLinux operating systemsOracle Solaris operating systemsTask
AIX 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 systemsLinux operating systemsOracle Solaris operating systemsTask
AIX 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