You can display a table of contents of the files or qtrees in a tape file for a tape restore. This is useful in determining what files or qtrees exist on a tape and their locations. For qtrees, the restore lists the qtree properties.
A table-of-contents restore takes much less time than a full restore because only the list of files in the backup is read. However, it uses a lot of CPU time because of the extensive output produced.
In general, you should run a table-of-contents restore from a Remote Shell connection because an enormous output is generated. Usually, you can control the output more easily when it is sent to a client console rather than to the storage system console. Also, client consoles are more flexible and enable you to save the output.
Also, you rarely need to change tapes with a table-of-contents restore. The command needs to read only the directory information from the tape and none of the files or qtrees. Because directory information tends to constitute a small part of a backup, it is almost always located on one tape. Also, table-of-contents restores work with multiple tape files specified on the command line.
You can specify two types of tables of contents: file and qtree. These are explained in the following table.
|File||Lists all the file names in a backup.
If you specify path names, only the files in the path names are listed.
|Qtree||Lists qtrees and their settings for security style and Windows NT oplocks for all qtrees.
If you specify qtree names, the information for only those qtrees is listed if they are in the backup.
You cannot combine the two types in a single command.