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:
- 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 Tivoli Storage Manager
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 Tivoli Storage Manager 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 Tivoli Storage Manager API
must be installed to use the query image command.
Supported Clients
This command
is valid for AIX®, HP-UX, all Linux clients, and Solaris.
This command is valid for all Windows clients.
Syntax
>>-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.
| 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 kutras at
node avalon .
Command: query image -fromnode=avalon -fromowner=kutras
- Task
- Display active and inactive version of the /usr image.
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