Imagegapsize

Use this option for LAN-based and LAN-free image backup.

For example, if you specify a gap size of 10, this means that an empty region on the disk that is larger than 10 KB in size is not backed up. Gaps that are exactly 10 KB are backed up. Empty regions that are exactly 10 KB and that are smaller than 10 KB is backed up, even though they do not contain data. However, an empty region that is smaller than 10 KB is backed up, even though it does not contain data. A smaller image gap size means less data needs to be transferred, but with potentially decreased throughput. A larger image gap size results in more data being transferred, but with potentially better throughput.

Place the include.image statement containing the imagegapsize value in your dsm.opt file.

Supported Clients

This option is valid for AIX®, Linux, and JFS2 clients only. The IBM Spectrum Protect™ API does not support this option.

This option is valid for all Windows clients. The IBM Spectrum Protect API does not support this option.

Options File

Place this option in the server stanza of the client systems options file (dsm.sys), or in the include.image statement in the dsm.sys file.

Place this option in the client options file (dsm.opt).

Parameters

size

Specifies the minimum size of empty regions in an AIX JFS2 file system that should be skipped during an image backup. You can specify k (kilobytes) m (megabytes) or g (gigabytes) qualifiers with the value. Without a qualifier, the value is interpreted in kilobytes. Valid values are 0 through 4294967295 KB. If you specify a value of 0, all blocks, including unused blocks at the end of the volume, is backed up. If you specify any value other than 0, unused blocks at the end of the volume are not backed up. For LAN-based and LAN-free image backup the default value is 32 KB. This option is applicable to both static and snapshot-based image backup.

Note: This option is valid for AIX JFS2 file systems. If you specify an imagegapsize that is greater than 0 for a file system other than AIX JFS2, you get a warning message.

size

Specifies the minimum size of empty regions in a formatted logical volume that should be skipped during an image backup. You can specify k (kilobytes) m (megabytes) or g (gigabytes) qualifiers with the value. Without a qualifier, the value is interpreted in KB. Valid values are 0 through 4294967295 KB. If you specify a value of 0, all blocks, including unused blocks at the end of the volume, is backed up. If you specify any value other than 0, unused blocks at the end of the volume are not backed up. For LAN-based and LAN-free image backup the default value is 32 KB.

Note: Because of operating system limitations, use this option for NTFS file systems only. If you specify an imagegapsize that is greater than 0 for a file system other than NTFS, you get a warning message.