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:

• 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.

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.

Examples

Example 2-78 displays the volumes in library lib1. Note that the sample output has been reformatted to fit on the page.

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.

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