Skip Headers
Oracle® Secure Backup Reference
Release 10.1

Part Number B14236-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

labelvol

Purpose

Use the labelvol command to load selected volumes and write new volume labels to these volumes.

Caution:

This command erases all existing data on the selected volumes.

In Oracle Secure Backup, a volume label typically contains a Volume ID—for example, lev0-0001—and a volume tag, which is a barcode. These two attributes uniquely identify a tape. Normally, Oracle Secure Backup creates a volume label when it first writes to a tape. You may want to label a volume manually in the following circumstances:

See Also:

"Library Commands" for related commands

Prerequisites

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

Syntax

labelvol::=

lab•elvol [ --drive/-D drivename ] [ --barcode/-b barcode ] 
[ --force/-f ] [ --obtaropt/-o obtar-option ]... [ se-range ]

Semantics

--drive/-D drivename

Specifies the name of the tape drive to be used to label the volume. If you do not specify a tape drive name, then the drive variable must be set.

--barcode/-b barcode

Specifies a barcode for the volume.

--force/-f

Forces the labeling of a volume. Executing the command with this option overrides any conditions that would otherwise prevent the labelvol command from functioning. This option enables you to overwrite unexpired volumes. Also, you can overwrite an incorrect manual entry for a barcode without the currently required prior step of executing an unlabelvol command.

--obtaropt/-o obtar-option ...

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.

se-range

Specifies a range of storage elements holding the volumes to be labeled. If omitted, then the volume currently loaded in the specified drive is labeled. Refer to "se-range" for a description of the se-range placeholder.

Example

Example 2-42 reserves the tape in storage element 4 in library lib1 for use by media family mf_incr.

Example 2-42 Manually Labeling a Volume

ob> insertvol unlabeled --library lib1 4
ob> labelvol --drive tape1 --obtaropt -Xfam:mf_incr 4