Oracle® Secure Backup Reference Release 10.1 Part Number B14236-03 |
|
|
View PDF |
Purpose
Use the lsvol
command to list the volumes in a library or the volumes catalog.
Oracle Secure Backup uses the following SCSI terms to describe basic components of libraries:
A storage element, identified in the lsvol
output as a number, contains a volume when it is not in use.
An import-export element, identified in the lsvol
output with the prefix iee
, is used to move volumes into and out of the library without opening the door (thus requiring a full physical inventory). It is sometimes called a mail slot and is physically present only on certain libraries.
A medium transport element, identified in the lsvol
output as mte
, moves a volume from a storage element to another element, such as a tape drive.
A data transfer element, identified in the lsvol
output as dte
, is a tape drive.
Each element has a name that you and Oracle Secure Backup use to identify it. For example, the first storage element is usually named se1
and the first tape drive is dte1
. You can omit the se
prefix when referring to storage elements; you can refer to the drive in libraries (when libraries contain only one drive) as dte
.
See Also:
"Library Commands" for related commandsPrerequisites
You must have the right to query and display information about devices to use the lsvol
command.
Syntax
Syntax 1
Use the following syntax to list the volumes (inventory) in a library. See "Semantics for Syntax 1".
lsv•ol [ --library/-L libraryname | --drive/-D drivename ] [ --long/-l ]
Syntax 2
Use the following syntax to list the volumes in the volumes catalog. See "Semantics for Syntax 2".
lsv•ol [ --short/-s | --long/-l ] [ --relation/-r ] [ --members/-m ] [ --noheader/-H ] [ --contents/-c ] { --all/-a | { [ --vid/-v vid[,vid]... ] [ --barcode/-b tag[,tag]... ] [ --vset/-V vsetid[,vsetid]... ] [ --family/-f media-family-name[,media-family-name]... ] [ --attribute/-A volume-attr[,volume-attr]... ] [ --oid/-o oid[,oid]... ] }... [ --novid/-n | --nobarcode/-N ] }
Semantics
Semantics for Syntax 1
Specifies the name of the library holding the volumes to be listed.
If you do not specify --library
or --drive
, then Oracle Secure Backup uses the value of the library or drive variable. Oracle Secure Backup issues a warning if it can obtain neither the library nor drive setting.
Specifies the name of a tape drive in the library holding the volumes to be listed.
If you do not specify --library
or --drive
, then Oracle Secure Backup uses the value of the library or drive variable. Oracle Secure Backup issues a warning if it can obtain neither the library nor drive setting.
Displays volume information in long format. If you specify lsvol --long
with no other options, then the command displays an inventory of the DTE, MTE, and storage elements of the library. If you specify --long
for particular volumes, then the command displays the OID, volume ID, barcode, volume sequence, and so forth.
Semantics for Syntax 2
Displays volume information in short format. The command displays only the volume ID for each volume.
Displays volume information in long format.
Groups volumes according to the other options specified. For example, if you specify the --family
option, then obtool
sorts according to volumes belonging to the specified media family.
Displays all volume set members for each volume displayed. This option is the default.
Displays information without header output.
Displays information about the contents of each volume.
Displays all volumes in the volumes catalog.
Displays the volume having the volume ID vid. Refer to "vid" for a description of the vid placeholder.
Displays the volume with the barcode tag.
Displays volumes that are members of the volume set vsetid. The vsetid represents the vid of the first volume in the volume set. Refer to "vid" for a description of the vid placeholder.
Displays all volumes of the specified media family. The media-family-name placeholder represent the name of a media family assigned by means of the mkmf or renmf command.
Displays all volumes with the attribute volume-attr. Valid values for this placeholder are the following:
o•pen
, which means that the volume is open for writing
c•losed
, which means that the volume is closed for writing
e•xpired
, which means that the volume is expired
u•nexpired
, which means that the volume is not expired
Displays volumes with the specified oid. Refer to "oid" for a description of the oid placeholder.
Displays volumes with no volume ID.
Displays volumes with no barcode.
Output
Table 2-22 describes the output of the lsvol
command.
Table 2-22 lsvol Output
Column | Indicates |
---|---|
VOID |
Catalog identifier for the volume |
Seq |
Number of the tape in the volume set |
Volume ID |
Unique volume identifier; typically the media family plus incrementing numbers |
Barcode |
Barcode label identifier affixed to the tape |
Family |
Media family name |
Created |
Date the volume was first written to |
Attributes |
Retention or expiration characteristics |
Examples
Example 2-78 displays the volumes in library lib1
. Note that the sample output has been reformatted to fit on the page.
Example 2-78 Displaying the Volumes in a Library
ob> lsvol --long --library lib1 Inventory of library lib1: in mte: vacant in 1: volume VOL000002, barcode ADE201, oid 110, 16962752 kb remaining in 2: volume VOL000001, barcode ADE203, oid 102, 17619328 kb remaining in 3: vacant in 4: vacant in iee1: vacant in iee2: vacant in iee3: vacant in dte: volume RMAN-DEFAULT-000002, barcode ADE202, oid 112, 17017984 kb remaining, content manages reuse, lastse 3
Example 2-79 displays the contents of volume VOL000001
. Note that the sample output has been reformatted to fit on the page.