insertvol

Purpose

Use the insertvol command to notify Oracle Secure Backup that you have manually inserted volumes into the specified destinations in the library and specify the properties of the inserted volumes. Oracle Secure Backup updates the inventory with the supplied information.

See Also:

"Library Commands" for related commands

Prerequisites

You must have the right to manage devices and change device state to use the insertvol command.

Syntax

Syntax 1

Use the following syntax to specify that you have inserted unlabeled or unknown volumes or cleaning tapes. See "Semantics for Syntax 1".

insertvol::=

ins•ertvol [ --library/-L libraryname | --drive/-D drivename ]
{ unknown | unlabeled | clean --uses/-u n --maxuses/-m n }
se-range

Syntax 2

Use the following syntax to specify that you have inserted known or labeled volumes. See "Semantics for Syntax 2".

insertvol::=

ins•ertvol [ --library/-L libraryname | --drive/-D drivename ]
{ vol-spec } se-spec

Semantics

Semantics for Syntax 1

The following options enable you to insert unlabeled or unknown volumes or cleaning tapes.

--library/-L libraryname

Specifies the name of the library in which you want to insert one or more volumes.

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 in which you want to insert one or more volumes.

unknown

Indicates the volume being inserted is of unknown format.

unlabeled

Indicates that the volume inserted is known to be unlabeled or a new volume.

clean

Indicates that the volume being inserted is a cleaning tape. You must specify this option in conjunction with the --uses and --maxuses options.

--uses/-u n

Specifies the number of times that the cleaning tape has been used.

--maxuses/-m m

Specifies the maximum number of times that the cleaning tape can be used. The number of remaining uses for the cleaning tape is the difference between --maxuses and --uses.

se-range

Specifies a range of storage elements into which the volumes were inserted. Refer to "se-range" for a description of the se-range placeholder.

Semantics for Syntax 2

The following options enable you to insert labeled or known volumes.

vol-spec: Specifies the volume ID of the inserted volume. Refer to "vol-spec" for a description of the vol-spec placeholder.
se-spec: Specifies the storage element into which the volume was inserted. Refer to "se-spec" for a description of the se-spec placeholder.

Example

Example 2-40 informs Oracle Secure Backup that a cleaning tape is inserted into storage element 2 of library lib1. Note that the sample output is reformatted so that it fits on the page.

Example 2-40 Notifying Oracle Secure Backup of a Manually Inserted Volume

ob> lsvol --library lib1 --long
Inventory of library lib1:
    in    mte:           vacant
    in    1:             volume VOL000001, barcode ADE201, oid 102, 48359360 kb 
                         remaining
    in    2:             vacant
    in    3:             volume RMAN-DEFAULT-000002, barcode ADE202, oid 112, 
                         47773408 kb remaining, content manages reuse
    in    4:             vacant
    in    iee1:          vacant
    in    iee2:          vacant
    in    iee3:          vacant
    in    dte:           vacant
ob> insertvol --library lib1 clean --uses 0 --maxuses 3 2
ob> lsvol --library lib1 --long
Inventory of library lib1:
    in    mte:           vacant
    in    1:             volume VOL000001, barcode ADE201, oid 102, 48359360 kb 
                         remaining
    in    2:             barcode ADE203, cleaning tape: 0 uses, 3 remaining
    in    3:             volume RMAN-DEFAULT-000002, barcode ADE202, oid 112, 
                         47773408 kb remaining, content manages reuse
    in    4:             vacant
    in    iee1:          vacant
    in    iee2:          vacant
    in    iee3:          vacant
    in    dte:           vacant