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

lsvol

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:

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 commands

Prerequisites

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

--library/-L libraryname

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.

--drive/-D drivename

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.

--long/-l

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

--short/-s

Displays volume information in short format. The command displays only the volume ID for each volume.

--long/-l

Displays volume information in long format.

--relation/-r

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.

--members/-m

Displays all volume set members for each volume displayed. This option is the default.

--noheader/-H

Displays information without header output.

--contents/-c

Displays information about the contents of each volume.

--all/-a

Displays all volumes in the volumes catalog.

--vid/-v vid ...

Displays the volume having the volume ID vid. Refer to "vid" for a description of the vid placeholder.

--barcode/-b tag ...

Displays the volume with the barcode tag.

--vset-/V vsetid ...

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.

--family/-f media-family-name ...

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.

--attribute/-A volume-attr ...

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

--oid/-o oid ...

Displays volumes with the specified oid. Refer to "oid" for a description of the oid placeholder.

--novid/-n

Displays volumes with no volume ID.

--nobarcode/-N

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.

Example 2-79 Displaying the Contents of a Volume

ob> lsvol --contents --vid VOL000001
    VOID Seq Volume ID      Barcode   Family      Created     Attributes
     102   1 VOL000001      ADE203                03/31.10:10 never closes
        BSOID  File Sect  Level  Host             Created     Attributes
          100     1 1         0  brhost2          03/31.10:10