If, during tape copy pre-processing in Windows, the locking process fails because of the need to avoid a temporary conflict with another application trying to access the backup volume, the locking process will be retried.
The standard retry process is as follows:
If the locking process fails, it is attempted again after 1 second has elapsed.
If a lock cannot be established after 20 retries (making a total of 21 attempts), the process is interrupted and the command is forced to terminate abnormally.
The maximum number of retries (20 by default) and the retry interval (1 second by default) can be modified by creating a setup file called a "backup volume lock specification file for tape copying".
This setup file can also be used to direct tape copy pre-processing to perform the following operations:
To disable all file handles within a volume before retrying the locking process (Forced locking function)
To skip locking/unlocking during tape copy pre-processing
Note
The backup volume lock specification file for tape copying is not backed up by swstresback (Resource backup command). If the backup volume lock specification file for tape copying is being used, you will need to back it up using a command such as copy.
Creating the backup volume lock specification file for tape copying
To create a backup volume lock specification file for tape copying, use the following file names.
File name | For non-cluster operation: environment settings directory \etc\backup\data\TCBACKLOCK.INI For cluster operation: <shared disk>:\etc\opt\swstorage\etc\backup\data\TCBACKLOCK.INI |
The following sample settings are for a backup volume lock specification file for tape copying.
[g1d2p1] LockForceMode=on LockRetryNumber=10 LockRetryInterval=10 [g1d2p2] NoPrePost=on [ANY] LockForceMode=off LockRetryNumber=20 LockRetryInterval=100 |
The backup volume lock specification file for tape copying is created as follows:
Create a section corresponding to the volume for which the locking operation will be changed, then enter the desired parameters. (In the above example, two sections, g1d1p1 and g1d2p2, have been created.) The four parameters shown in the following table can be changed, but it is not necessary to specify all four parameters. Specify only the parameters that need to be changed; the parameters that are not specified will assume their default values.
To change the default locking operation, create a section called "ANY" and specify the appropriate parameters. The "ANY" section can be used to change the locking operation of all volumes other than those explicitly specified in the backup volume lock specification file for tape copying. (In the above example, the locking operation of all volumes other than g1d1p1 and g1d2p2 will obey the values in the "ANY" section.)
TCBACKLOCK.INI setup items
Key | Description |
---|---|
LockForceMode | If locking of a backup volume fails, the locking process will be retried. This parameter specifies that the volume will be unmounted before the retry process begins. off (default) = Do not unmount the volume before the retry process on = Unmount the volume before the retry process When a volume is unmounted, all open handles on that volume will be disabled. Note: If a volume is in use soon after it has been unmounted, it may not be possible to lock it. This parameter is disabled if NoPrePost is set to on. |
LockRetryNumber | If locking of a backup volume fails, the locking process will be retried. This parameter specifies the number of retries to be performed. Any interval between 1 and 10,000 can be specified. The default value is 20 retries. If a backup volume cannot be locked after the specified number of retries has been performed, the process is suspended and the command is forced to terminate abnormally. This parameter is disabled if NoPrePost is set to on. |
LockRetryInterval | If locking of a backup volume fails, the locking process will be retried. This parameter specifies the interval (in milliseconds) between each retry operation. Any interval between 1 and 600,000(10 minutes) can be specified. The default value is 1,000 (1 second). This parameter is disabled if NoPrePost is set to on. |
NoPrePost | This parameter specifies that tape copy pre-processing will not be performed. off (default) = Perform tape copy pre-processing and post-processing on=Do not perform tape copy pre-processing and post-processing When NoPrePost is set to on, all other parameters (LockForceMode, LockRetryNumber and LockRetryInterval) are disabled. |