importvol

用途

importvolコマンドは、テープ・ライブラリのインポート/エクスポート装置から記憶域要素に1つ以上のボリュームを移動する場合に使用します。このコマンドは、インポート/エクスポート・スロットのあるライブラリに対してのみサポートされます。

importvolコマンドは、次の点でmovevolコマンドと異なります。

テープ・ライブラリ・マネージャによって、使用される移動先の記憶域要素が決定される。
テープ内容を移動中に確認できる。
1つのコマンドで複数のテープを移動できる。

関連項目:

関連コマンドについては、「ライブラリ用コマンド」を参照してください。

前提条件

importvolコマンドを使用するには、デバイスの管理およびデバイスの状態変更（manage devices and change device state）権を備えている必要があります。

使用方法

importvolコマンドを受け取るライブラリに正常に機能する有効なバーコードがある場合、unlabeledオプションを指定することはできません。かわりに、インポートされるボリューム上のバーコードが読み取られて、ボリューム・データベース内での検索が試みられます。

データベース内で一致するレコードが見つかれば、そのレコードがターゲットの記憶域要素に関連付けられます。データベース内でバーコードが見つからなければ、スクラッチ・レコードが作成され、関連付けられたボリュームはunknownとマークされます。

構文

importvol::=

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

意味

--library/-L libraryname

テープをインポートするテープ・ライブラリの名前を指定します。テープ・ライブラリを指定すると、テープ・ライブラリ内にあるすべての空の記憶域要素が有効な移動先となります。リクエストを実行できるだけの十分な移動先がない場合は、コマンドを完全に処理できなかったことがレポートされます。

--libraryまたは--driveを指定しない場合は、libraryまたはdrive変数の値が使用されます。テープ・ライブラリとテープ・ドライブのいずれの設定も取得できない場合は、警告が発行されます。

--drive/-D drivename

テープをインポートするテープ・ライブラリのテープ・ドライブの名前を指定します。テープ・ドライブを指定すると、有効な移動先はテープ・ドライブの使用リスト内の記憶域要素のみに制限されます。

--identify/-i

各ボリュームのボリュームIDが読み取られます。このオプションは、identifyvolコマンドを実行することと同じです。このオプションでは、テープ・ドライブの指定が必要です。

--import/-m

すべてのボリュームのバックアップ・イメージ・ラベルが読み取られます。このオプションは、別の管理ドメイン内のボリュームをインポートする場合に使用できます。このオプションでは、テープ・ドライブの指定が必要です。

--unlabeled/-u

インポートするすべてのボリュームをラベル付け解除済としてマークします。このオプションは、--identifyまたは--importと組み合せて使用することはできません。

importvolコマンドを受け取るライブラリに正常に機能する有効なバーコード・リーダーがある場合、unlabeledオプションを使用することはできません。

注意:

このオプションでは、実際にはボリュームのラベル付けは解除されません。insertvol unlabeledコマンドと同じです。

--obtaropt/-o obtar-option

ボリュームの読取り時にobtarに渡されるobtarオプションを指定します。たとえば、-Jを指定すると、デバッグ・モードが有効になり、バックアップおよびリストア記録に詳細が記述されます。obtarオプションの詳細は、「obtarのオプション」を参照してください。このオプションは、--identifyおよび--importオプションと組み合せた指定のみ有効です。

iee-range

インポート対象のボリュームが入っているインポート/エクスポート要素の範囲を指定します。iee-rangeの許容値は、「iee-range」を参照してください。

例

例2-39 ボリュームのインポート

この例では、インポート要素iee1、iee2およびiee3にあるボリュームをテープ・ライブラリlib2にインポートします。

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