Use the reusevol command to recycle selected volumes. Oracle Secure Backup loads the selected volumes and deletes their backup images.
Each volume has a volume label stored at Beginning of Tape (BOT). The label consists of the Volume ID, the barcode tag (if any), and other information about the volume. The reusevol command is similar to the unlabelvol command, but reusevol directs Oracle Secure Backup to preserve the existing volume label.
See Also:
"Library Commands" for related commandsYou must have the right to manage devices and change device state to use the reusevol command.
reuse•vol [ --drive/-D drivename ] [ --force/-f ] [ --obtaropt/-o obtar-option ]... se-range
Specifies the name of the drive to be used to relabel the volume. If you do not specify a tape drive name, then the drive variable must be set.
Forces the reuse of a volume. Oracle Secure Backup disregards the expiration date, if any, found in the volume label. If the --force option is not employed and the volume is not expired, then reusevol fails.
Specifies obtar options. For example -J enables debug mode and provides more details in backup and restore transcripts. See the section entitled "obtar Options" for details on obtar options.
Specifies the range of storage elements holding the volumes to be reused. If omitted, then the volume currently loaded in the drive is reused. Refer to "se-range" for a description of the se-range placeholder.
Example 2-122 displays information about the tape located in storage element 2 of library lib1. The volume in this storage element is not empty. The reusevol command forcibly reuses the volume, thereby deleting its contents and removing its volume ID. The barcode of the volume is retained. Note that the sample output has been reformatted to fit on the page.
Example 2-122 Reusing a Volume
ob> lsvol --long --library lib1
Inventory of library lib1:
in mte: vacant
in 1: barcode ADE202, oid 117, 47447360 kb remaining, content manages reuse
in 2: volume VOL000004, barcode ADE204, oid 120, 47420448 kb remaining
in 3: barcode ADE201, oid 116, 47462976 kb remaining
in 4: volume VOL000001, barcode ADE200, oid 102, 47424064 kb remaining
in iee1: barcode ADE203, oid 114, 47725344 kb remaining,
lastse 4
in iee2: vacant
in iee3: vacant
in dte: vacant
ob> lsvol --barcode ADE204 --content
VOID Seq Volume ID Barcode Family Created Attributes
120 1 VOL000004 ADE204 04/01.09:16 never closes
BSOID File Sect Level Host Created Attributes
172 1 1 0 brhost2 04/01.09:16
ob> reusevol --drive tape1 --force 2
ob> lsvol --barcode ADE204 --content
VOID Seq Volume ID Barcode Family Created Attributes
122 ADE204