Use the toc option with the backup nas command or the include.fs.nas option to specify whether Tivoli® Storage Manager 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 Tivoli Storage Manager 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 client
API does not support this option.
This option
is valid for all Windows clients.
The Tivoli Storage Manager client
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 Tivoli Storage Manager 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 Tivoli Storage Manager does not save TOC information during a NAS file system image backup.
- Preferred
- Specifies that Tivoli Storage Manager 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, Tivoli Storage Manager 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