The incrthreshold option specifies the
threshold value for the number of directories in any journaled file
space that might have active objects on the server, but no equivalent
object on the workstation.
When a Windows client
deletes a file or directory with a long name, it sometimes reports
this using a compressed name. After the object is deleted, the compressed
name might be reused and the deletion notice can no longer identify
a unique object. During a journaled incremental backup of a file space,
this can result in the no active version response from the
server resulting in an unsuccessful expire for an object.
The incrthreshold option
allows you to specify what to do when this condition arises:
- If you set the incrthreshold option to 0 (the
default), Tivoli® Storage Manager takes
no action. The primary consequence is that, during a restore of such
a directory, these objects might be inadvertently restored. When the
next non-journaled incremental is run on this directory, Tivoli Storage Manager expires
all objects in the directory that exist on the server but not on the
workstation.
- If you specify a value greater than zero, Tivoli Storage Manager saves
the directory name of an object in the journal during journaled backups.
During a full file space journaled incremental backup, if the number
of directories in the file space is greater than or equal to this
value, a full incremental backup of each directory occurs. This takes
place automatically after completion of the journaled backup and does
not require entry of another command.
- If you set the incrthreshold option to 1, Tivoli Storage Manager performs
a full incremental backup of these directories whenever a no active
version response is received during a full file space journaled
incremental backup.
Supported Clients
This option is for all Windows clients.
Options File
Place this option in the client
options file (dsm.opt). You can set this option on the field of the Preferences
editor.
Syntax
>>-INCRTHreshold--numberdirectories----------------------------><
Parameters
- numberdirectories
- Specifies the threshold value for the number of directories in
any journaled file space that might contain active files that should
be expired. When this threshold is reached during a full file space
journaled incremental, the client initiates an incremental backup
on each such directory at the completion of the journaled backup.
The range of values is 0 through 2,000,000,000; the default is 0.
Examples
- Options file:
- incrthreshold 1
- Command line:
- -increthreshold=1
This option is valid only
on the initial command line. It is not valid in interactive mode.