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.
- Stored 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.
- Stored 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
This option is
valid for AIX®, Linux,
and Oracle Solaris clients.
This command is valid for all Windows clients.
Syntax
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.
| Option | Where to use |
|---|---|
| backupsetname | Command line only. |
| dateformat |
Client user option
file (dsm.opt) or command line. |
| dateformat |
Client option file
(dsm.opt) or command line. |
| fromnode | Command line only. |
| fromowner |
Command line only. |
| inactive | Command line only. |
| numberformat |
Client user option
file (dsm.opt) or command line. |
| numberformat |
Client option file
(dsm.opt) or command line. |
| pitdate | Command line only. |
| pittime | Command line only. |
| scrolllines |
Client user options
file (dsm.opt) or command line. |
| scrolllines |
Client options file
(dsm.opt) or command line. |
| scrollprompt |
Client user options
file (dsm.opt) or command line. |
| scrollprompt |
Client options file
(dsm.opt) or command line. |
| timeformat |
Client user option
file (dsm.opt) or command line. |
| timeformat |
Client option file
(dsm.opt) or command line. |
Examples
- Task
- Display all backed up images.
Command:
q image - Task
- Display all backed up images that are owned by
kutrasat nodeavalon.Command:
query image -fromnode=avalon -fromowner=kutras - Task
- Display active and inactive version of the
/usrimage.Command:
q i /usr -inactive - Task
- Display 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