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.

Linux operating systemsOracle Solaris operating
systemsAIX 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.

Windows operating systemsLinux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systems

Supported Clients

Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsThis option is valid for all UNIX and Linux® clients. The server can also define this option. The IBM® Storage Protect API does not support this option.

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

Options File

Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsPlace this option in the client system-options file (dsm.sys) 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 diagramCHAngingretries  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