Windows operating systems

Incrthreshold

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 Backup > Threshold for non-journal incremental backup field of the Preferences editor.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-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.