borrowdev

Purpose

Use the borrowdev command to borrow a drive.

You use the borrowdev command if a backup or restore job is requesting assistance. You can reply to the input request by using the rpyjob command, but this technique can be cumbersome for multiple commands because obtool issues a new prompt after each command. The borrowdev command temporarily overrides the device reservation made by the requesting job and enables you to execute arbitrary library or drive commands. You can use the returndev command to release the drive and use the catxcr or rpyjob commands to resume the job.

See Also:

"Device Commands" for related commands

Prerequisites

You must have the right to manage devices and change device state to use the borrowdev command.

Syntax

borrowdev::=

bor•rowdev drive-name ...

Semantics

drive-name: Specifies the name of the drive that you want to borrow.

Example

In Example 2-5, backup job admin/6 is not proceeding. Executing the catxcr command reveals that Oracle Secure Backup cannot find a usable tape for the backup.

Example 2-5 Displaying the Transcript for a Hanging Backup

End of tape has been reached.  Please wait while I rewind and unload the tape. The Volume ID of the
next tape to be written is VOL000007. The tape has been unloaded.
 
obtar: couldn't perform auto-swap - can't find usable volume in library (OB device mgr)
   Enter a command from the following list:
       load <n>     .. load the tape from element <n> into the drive
       unload <n>   .. unload the tape from the drive into element <n>
       help         .. display other commands to modify drive's database
       go           .. to use the tape you selected
       quit         .. to give up and abort this backup or restore
:

Assume that you press the Enter key to return to the obtool prompt. In Example 2-6, you insert a new tape into slot 2 of the library, borrow the tape drive, load the volume from slot 2 into the drive, and then release the drive with the returndev command.

Example 2-6 Borrowing a Tape Drive

ob> lsvol --long
Inventory of library lib1:
    in    mte:           vacant
    in    1:             volume VOL000006, barcode ADE201, oid 116, full
    in    2:             vacant
    in    3:             vacant
    in    4:             vacant
    in    dte:           vacant
ob> insertvol unlabeled 2
ob> borrowdev tape1
ob> loadvol 2
ob> returndev tape1

In Example 2-7, you execute the catxcr command for the job and then enter go at the prompt to resume the backup.

Example 2-7 Resuming a Job After Borrowing a Device

ob> catxcr admin/6.1
admin/6.1: 2005/04/11.18:36:44 ______________________________________________________________________
admin/6.1: 2005/04/11.18:36:44
admin/6.1: 2005/04/11.18:36:44         Transcript for job admin/6.1 running on brhost2
.
.
.
admin/6.1: Backup started on Mon Apr 11 2005 at 18:36:44
admin/6.1: Volume label:
admin/6.1:    Enter a command from the following list:
admin/6.1:        load <n>     .. load the tape from element <n> into the drive
admin/6.1:        unload <n>   .. unload the tape from the drive into element <n>
admin/6.1:        help         .. display other commands to modify drive's database
admin/6.1:        go           .. to use the tape you selected
admin/6.1:        quit         .. to give up and abort this backup or restore
admin/6.1: :
admin/6.1: : go