DRIVEACQUIRERETRY

The DRIVEACQUIRERETRY option lets you specify how many times the server retries the acquisition of a drive in an IBM® 349x library. If the library is shared among multiple applications, its drives may appear to be available to the server (through the use of a background polling process) when they are not.

This option is only valid if you specified 3494SHARED YES in the dsmserv.opt file. If you specified DRIVEACQUIRERETRY NEVER, you need to monitor how long jobs have been waiting for drives and how long the server has been polling the drives. You may also need to check the status of these drives in the other Tivoli® Storage Manager servers. There may be cartridges stuck in the drives, and the other Tivoli Storage Manager servers may have marked the drives as offline. If this is the case, you need to mark the drives offline in the Tivoli Storage Manager server that is polling the drives. If necessary, also cancel any waiting jobs.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-DRIVEACQuireretry--+-Forever-----------+--------------------><
                      +-Never-------------+   
                      '-number_of_retries-'   

Parameters

Forever
The acquisition of a drive is retried until one is successfully acquired. This is the default.
Never
The server does not retry the acquisition of a drive and fails the operation.
number_of_retries
Specifies the maximum number of times, from 1 to 9999, that the server retries the acquisition of a drive.

Examples

Specify that the server should attempt no more than 10 times to acquire the drive:

driveacquireretry 10