Installation and User's Guide

decreased throughput. A larger image gap size results in more data beingtransferred, but with potentially better throughput.Place the include.image statement containing the imagegapsize value in yourdsm.opt file.Supported ClientsThis option is valid for all Windows clients. The Tivoli Storage Manager client APIdoes not support this option.Options FilePlace this option in the client options file (dsm.opt).Syntax►► IMAGEGapsize size ►◄ParameterssizeSpecifies the minimum size of empty regions in a formatted logical volumethat should be skipped during an image backup. You can specify k (kilobytes)m (megabytes) or g (gigabytes) qualifiers with the value. Without a qualifier, thevalue is interpreted in kilobytes. Valid values are 0 through 4294967295 KB. Ifyou specify a value of 0, all blocks, including unused blocks at the end of thevolume, is backed up. If you specify any value other than 0, unused blocks atthe end of the volume will not be backed up. For LAN-based and LAN-freeimage backup the default value is 32 k.Note: Because of operating system limitations, use this option for NTFS filesystems only. If you specify an imagegapsize that is greater than 0 for a filesystem other than NTFS, you get a warning message.ExamplesOptions file:imagegapsize 1mInclude-exclude list example: include.image h: MYMC imagegapsize=1mCommand line:-imagegapsize=64kImagetofileUse the imagetofile option with the restore image command to specify that youwant to restore the source image to a file.You might need to restore the image to a file if bad sectors are present on thetarget volume, or if you want to manipulate the image data. Later, you can use adata copy utility of your choice to transfer the image from the file to a diskvolume.392 IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide