QUERY TOC (Display table of contents for a backup image)

Use this command to display directory and file information contained in the table of contents (TOC) for a specified backup image. This command does not load table of contents information into the IBM® Tivoli® Storage Manager database. The specified table of contents are read from a storage pool each time the QUERY TOC command is issued.

This command cannot be issued from the server console. If the table of contents is stored on removable media, a mount point is required and output is delayed while the storage pool volume is mounted.

Privilege class

To issue this command you must have either system privilege, policy privilege for the domain to which the node is assigned, or client owner authority over the node.

Syntax


>>-Query TOC--node_name--filespace_name------------------------->

>--+----------------------------------------------+------------->
   '-CREATIONDate--=--date--CREATIONTime--=--time-'   

   .-Format--=--Standard-----.   
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'   
                '-Detailed-'

Parameters

node_name (Required)

Specifies the name of the NAS node to which the table of contents (TOC) belongs. You cannot use wildcards to specify this name.

filespace_name (Required)

Specifies the name of the file space to which the table of contents belongs. The file space name you specify cannot contain wildcard characters.

CREATIONDate

Specifies the creation date of the backup image for which the table of contents is to be displayed. This parameter is optional. If you specify CREATIONDATE, you must also specify CREATIONTIME. If you do not specify these parameters, the contents of the latest backup image for the specified node and file space will be displayed, provided that this image has a table of contents. You can only specify the creation date as the following:

Value	Description	Example
MM/DD/YYYY	A specific date	05/15/2002

This specifies that you want to display the contents of the backup image created on this date. You can obtain this date from the output of the QUERY NASBACKUP command.

CREATIONTime

Specifies the creation time of the backup image for which the table of contents is to be displayed. This parameter is optional. If you specify CREATIONTIME, you must also specify CREATIONDATE. If you do not specify these parameters, the contents of the latest backup image for the specified node and file space will be displayed, provided that this image has a table of contents. You can only specify the creation time as the following:

Value	Description	Example
HH:MM:SS	A specific time on the specified creation date.	10:30:08

This specifies that you want to display the contents of the backup image created on this time for the specified date. You can obtain this time from the output of the QUERY NASBACKUP command.

Format

Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. Possible values are:

Standard: Specifies that partial information is displayed for the files.
Detailed: Specifies that complete information is displayed for the files, including the hexadecimal representation of each file or directory name.

Example: Display detailed table of contents information for a specific node

Use the QUERY TOC command to display information in the table of contents belonging to NAS node NETAPP in the file space /vol/vol1 created on 12/06/2002 at 11:22:46. Specify a detailed format.

query toc netapp /vol/vol1 creationdate=12/06/2002 creationtime=11:22:46
    format=detailed

Objects in the image backed up on 12/06/2002 11:22:46
for filespace /vol/vol1 in node NETAPP:
                                

                                Object Name: /.etc
                    Hexadecimal Object Name: 2f657463 
                                Object Type: Directory
                                Object Size: 4,096
           Last data Modification Date/Time: 07/31/2002 14:21:19
                                 
                                Object Name: /.etc/oldmaps/ndmp
                    Hexadecimal Object Name: 2f6574632f6f6c646d6170
                                             732f6e646d70
                                Object Type: Directory 
                                Object Size: 4,096
           Last data Modification Date/Time: 07/31/2002 14:21:19
                                 
                                Object Name: /.etc/oldmaps/ndmp/TSM
                                            /vol/vol1/3df0e8fd
                    Hexadecimal Object Name: 2f6574632f6f6c646d6170
                                             732f6e646d702f54534d2
                                             02f766f6c2f766f6c312f3
                                             364663065386664
                                Object Type: File
                                Object Size: 36,864
           Last data Modification Date/Time: 12/06/2002 11:14:22

Related commands

Table 1. Commands related to QUERY TOC
Command	Description
BACKUP NODE	Backs up a network-attached storage (NAS) node.
QUERY NASBACKUP	Displays information about NAS backup images.
RESTORE NODE	Restores a network-attached storage (NAS) node.