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 commandsYou must have the right to manage devices and change device state to use the insertvol command.
Use the following syntax to specify that you have inserted unlabeled or unknown volumes or cleaning tapes. See "Semantics for Syntax 1".
ins•ertvol [ --library/-L libraryname | --drive/-D drivename ] { unknown | unlabeled | clean --uses/-u n --maxuses/-m n } se-range
Use the following syntax to specify that you have inserted known or labeled volumes. See "Semantics for Syntax 2".
ins•ertvol [ --library/-L libraryname | --drive/-D drivename ] { vol-spec } se-spec
The following options enable you to insert unlabeled or unknown volumes or cleaning tapes.
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.
Specifies the name of a tape drive in 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.
Indicates the volume being inserted is of unknown format.
Indicates that the volume inserted is known to be unlabeled or a new volume.
Indicates that the volume being inserted is a cleaning tape. You must specify this option in conjunction with the --uses and --maxuses options.
Specifies the number of times that the cleaning tape has been used.
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.
Specifies a range of storage elements into which the volumes were inserted. Refer to "se-range" for a description of the se-range placeholder.
The following options enable you to insert labeled or known volumes.
Specifies the volume ID of the inserted volume. Refer to "vol-spec" for a description of the vol-spec placeholder.
Specifies the storage element into which the volume was inserted. Refer to "se-spec" for a description of the se-spec placeholder.
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