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
This option is only valid for AIX® and Solaris clients. The Tivoli® Storage Manager API does not support this option.
This option is valid for all Windows clients. The Tivoli Storage Manager API does not support this option.
Options File
Place the include.fs.nas statement containing the toc value in the dsm.sys file within a server stanza.
Place the include.fs.nas statement containing the toc value in the client options file (dsm.opt).
Syntax
.-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
- Command line:
- backup nas -nasnodename=netappsj /vol/vol0 -toc=yes
- Command line:
- backup nas -nasnodename=netappsj {/vol/vol0} -toc=yes