Changingretries

The changingretries option specifies how many additional times you want the client to attempt to back up or archive a file that is in use. Use this option with the archive, incremental, and selective commands.

This option is applied only when copy serialization, an attribute in a management class copy group, is shared static or shared dynamic.

With shared static serialization, if a file is open during an operation, the operation repeats the number of times that you specify. If the file is open during each attempt, the operation does not complete.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWith shared dynamic serialization, if a file is open during an operation, the operation repeats the number of times that you specify. The backup or archive occurs during the last attempt whether the file is open or not.

Windows operating systemsWith shared dynamic serialization, if a file is open during an operation, the operation repeats the number of times that you specify. The backup or archive occurs during the last attempt whether the file is open or not. Open file support can be used to back up files that are locked or in use.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systems

Supported Clients

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsThis option is valid for all UNIX and Linux clients. The server can also define this option. The Tivoli® Storage Manager client API does not support this option.

Windows operating systemsThis option is valid for all Windows clients. The server can also define this option. The Tivoli Storage Manager client API does not support this option.

Options File

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsPlace this option in the dsm.sys file within a server stanza. You can set this option on the Backup tab, Number of retries if file is in use field of the Preferences editor.

Windows operating systemsPlace this option in the client options file (dsm.opt). You can set this option on the Backup tab, Number of retries if file is in use field of the Preferences editor.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-CHAngingretries- numberretries------------------------------><

Parameters

numberretries
Specifies the number of times a backup or archive operation is attempted if the file is in use. The range of values is zero through 4; the default is 4.

Examples

Options file:
changingretries 3
Command line:
-cha=3