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.

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.

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.

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

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