inventory

Purpose

Use the inventory command to initiate a scan of the contents of a library.

Oracle Secure Backup does not automatically detect changes to a library that result from manual actions such as opening the library door to move or remove a tape. Use the inventory command in such circumstances to make the library detect the changes.

See Also:

"Library Commands" for related commands

Prerequisites

You must have the right to manage devices and change device state to run the inventory command.

Syntax

inventory::=

inv•entory [ --library/-L libraryname | --drive/-D drivename ] [ --force/-f ]

Semantics

--library/-L libraryname

Specifies the name of the library for which you want to update the inventory.

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 for which you want to update the inventory.

--force/-f

Forces the library to perform a physical inventory of the library. Instead of reading from its cache, the library updates the inventory by physically scanning all library elements.

Example

Example 2-41 forces the library lib1 to perform an inventory operation. Note that the sample output has been reformatted so that it fits on the page.

Example 2-41 Taking an Inventory of a Tape Library

ob> inventory --library lib1 --force
ob> lsvol --library lib1
Inventory of library lib1:
  * in    2:             volume VOL000001, barcode ADE201, 38919872 kb remaining
    in    iee1:          volume VOL000002, barcode ADE203, 38273920 kb remaining, lastse 1
    in    dte:           volume RMAN-DEFAULT-000002, barcode ADE202, 38328224 kb remaining, content 
                         manages reuse, lastse 3
 
  *: in use list