AIX operating systemsOracle Solaris operating systemsWindows operating systems

Toc

Use the toc option with the backup nas command or the include.fs.nas option to specify whether the backup-archive client saves table of contents (TOC) information for each file system backup.

You should consider the following when deciding whether you want to save TOC information:

  • If you save TOC information, you can use the QUERY TOC server command to determine the contents of a file system backup in conjunction with the RESTORE NODE server command to restore individual files or directory trees.
  • You can also use the web client to examine the entire file system tree and select files and directories to restore.
  • Creation of a TOC requires that you define the TOCDESTINATION attribute in the backup copy group for the management class to which this backup image is bound. Note that TOC creation requires additional processing, network resources, storage pool space, and possibly a mount point during the backup operation.
  • If you do not save TOC information, you can still restore individual files or directory trees using the RESTORE NODE server command, provided that you know the fully qualified name of each file or directory and the image in which that object was backed up.

Supported Clients

AIX operating systemsOracle Solaris operating systemsThis option is only valid for AIX® and Solaris clients. The Tivoli® Storage Manager API does not support this option.

Windows operating systemsThis option is valid for all Windows clients. The Tivoli Storage Manager API does not support this option.

Options File

AIX operating systemsOracle Solaris operating systemsPlace the include.fs.nas statement containing the toc value in the dsm.sys file within a server stanza.

Windows operating systemsPlace the include.fs.nas statement containing the toc value in the client options file (dsm.opt).

Syntax

Read syntax diagramSkip visual syntax diagram
        .-Preferred-.   
>>-TOC--+-----------+------------------------------------------><
        +-Yes-------+   
        '-No--------'   

Parameters

Yes
Specifies that the client saves TOC information during a NAS file system image backup. However, the backup fails if an error occurs during creation of the TOC.
No
Specifies that the client does not save TOC information during a NAS file system image backup.
Preferred
Specifies that the client saves TOC information during a NAS file system image backup. The backup does not fail if an error occurs during creation of the TOC. This is the default.
Note: If the mode option is set to differential and you set the toc option to preferred or yes, but the last full image does not have a TOC, the client performs a full image backup and creates a TOC.

Examples

Options file:
include.fs.nas netappsj/vol/vol0 homemgmtclass toc=yes
AIX operating systemsOracle Solaris operating systemsCommand line:
AIX operating systemsOracle Solaris operating systemsbackup nas -nasnodename=netappsj /vol/vol0 -toc=yes
Windows operating systemsCommand line:
Windows operating systemsbackup nas -nasnodename=netappsj {/vol/vol0} -toc=yes