importvol

Purpose

Use the importvol command to move one or more volumes from the import/export mechanism of a library to storage elements. This command is supported only for libraries that have import/export slots.

The importvol command differs from the movevol command in the following ways:

The library manager determines the destination storage elements to be used.
Tapes can be identified during the move.
A single command can move multiple tapes.

See Also:

"Library Commands" for related commands

Prerequisites

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

Syntax

importvol::=

imp•ortvol [ --library/-L libraryname | --drive/-D drivename ]
[ --identify/-i | --import/-m | --unlabeled/-u ] 
[ --obtaropt/-o obtar-option ]... 
iee-range

Semantics

--library/-L libraryname

Specifies the name of the library into which tapes are to be imported. If a library is specified, all empty storage elements in the library are valid destinations. If there are insufficient destinations to fulfill the request, obtool reports that the command could not be fully executed.

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 into which tapes are to be imported. If a drive is specified, valid destinations are limited to the storage elements in the drive's use list.

--identify/-i

Reads the volume label on each volume. This option is equivalent to executing the identifyvol command. This option requires specification of a tape drive.

--import/-m

Reads each backup image label on each volume. You can use this option if you are importing volumes from another administrative domain. This option requires specification of a tape drive.

--unlabeled/-u

Marks each imported volume as unlabeled. You cannot specify this option in conjunction with --identify or --import.

Note:

This option does not actually unlabel the volumes. It is equivalent to an insertvol unlabeled command.

--obtaropt/-o obtar-option ...

Specifies obtar options that are passed to obtar when the volumes are read. For example -J enables debug mode and provides more details in backup and restore transcripts. See the section entitled "obtar Options" for details on obtar options. This option is effective only for the --identify and --import options.

iee-range

Specifies a range of import/export elements containing the volumes to be imported. Refer to "iee-range" for acceptable values for iee-range.

Example

Example 2-39 imports volumes from import elements iee1, iee2, and iee3 into tape library lib2.

Example 2-39 Importing Volumes

ob> lsvol --long --library lib2
Inventory of library lib2:
    in    mte:           vacant
    in    1:             vacant
    in    2:             vacant
    in    3:             vacant
    in    4:             vacant
    in    iee1:          volume VOL000003, barcode DEV423, oid 111, 47711360 kb remaining, lastse 1
    in    iee2:          unlabeled, barcode DEV424, oid 114, lastse 1
    in    iee3:          unlabeled, barcode DEV425, oid 115, lastse 2
    in    dte:           vacant
ob> importvol --library lib2 iee1-3
ob> lsvol --long --library lib2
Inventory of library lib2:
    in    mte:           vacant
    in    1:             volume VOL000003, barcode DEV423, oid 111, 47711360 kb remaining
    in    2:             unlabeled, barcode DEV424, oid 114
    in    3:             unlabeled, barcode DEV425, oid 115
    in    4:             vacant
    in    iee1:          vacant
    in    iee2:          vacant
    in    iee3:          vacant
    in    dte:           vacant