---

lsvol

用途

lsvolコマンドは、テープ・ライブラリ内のボリュームまたはボリューム・カタログ内のボリュームをリストする場合に使用します。

複製ボリュームは、デフォルトでオリジナル・ボリュームごとにグループ化されます。lsvolコマンドでは、複製ボリュームごとにオリジナル・ボリュームoidが表示されます。

関連項目: oidプレースホルダの詳細は、「oid」を参照してください。

Oracle Secure Backupでは、次のSmall Computer System Interface（SCSI）用語を使用してライブラリの基本コンポーネントが記述されます。

• 記憶域要素。lsvolの出力内では数値として表示されます。使用されていないときでも、ボリュームが含まれています。

• インポート/エクスポート要素。lsvolの出力内では接頭辞iee付きで表示されます。ドアを開けずにボリュームをテープ・ライブラリの内外へ移動するために使用されます（したがって、完全な物理インベントリを行うことが必要です）。メール・スロットと呼ばれることもあり、物理的に特定のライブラリにのみ存在します。

• メディア転送要素。lsvolの出力内ではmteとして表示されます。記憶域要素からテープ・ドライブなどの別の要素にボリュームを移動します。

• データ転送要素（DTE）。lsvolの出力内ではdteとして表示されます。テープ・ドライブのことです。

各要素には、ユーザーとOracle Secure Backupが識別用に使用する名前があります。たとえば、最初の記憶域要素は通常se1、最初のテープ・ドライブはdte1と、それぞれネーミングされます。記憶域要素を参照する場合は、seの接頭辞を省略できます。ライブラリ内のテープ・ドライブはdteとして参照できます（ライブラリに内包されるドライブが1つのみの場合）。

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

前提条件

lsvolコマンドを使用するには、デバイス情報の問合せおよび表示（query and display information about devices）権を備えている必要があります。

構文1

ライブラリ内のボリュームをリスト（インベントリ）する場合は、次の構文を使用します。

lsvol [ --library/-L libraryname | --drive/-D drivename ]
[ --long/-l ]

意味1

--library/-L libraryname

リストするボリュームが搭載されているテープ・ライブラリの名前を指定します。

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

--drive/-D drivename

リストするボリュームが搭載されているテープ・ライブラリにあるテープ・ドライブの名前を指定します。

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

--long/-l

長い形式でボリューム情報が表示されます。lsvol --longをその他のオプションなしで指定した場合は、dte、mteおよびテープ・ライブラリの記憶域要素のインベントリが表示されます。特定のボリュームに対して--longを指定すると、OID、ボリュームID、バーコード、ボリューム順序などが表示されます。

構文2

ボリューム・カタログ内のボリュームをリストする場合は、次の構文を使用します。

lsvol [ --short/-s | --long/-l ] [ --relation/-r ] [ --members/-m ]
[ --duplicates/-d ][ --noheader/-H ] [ --contents/-c ]
{ --all/-a |
  { [ --vid/-v vid[,vid]... ] [ --barcode/-b tag[,tag]... ]
    [ --vset/-V vsetid[,vsetid]... ] [ [ --dset/-D dsetid[,dsetid]...]
    [ --family/-f media-family-name[,media-family-name]... ]
    [ --location/-C location-name[,location-name]... ]
    [ --attribute/-A volume-attr[,volume-attr]... ]
    [ --oid/-o oid[,oid]... ]
  }...
  [ --novid/-n | --nobarcode/-N ]
}

意味2

--short/-s

短い形式でボリューム情報が表示されます。各ボリュームのボリュームIDのみが表示されます。

--long/-l

長い形式でボリューム情報が表示されます。

--relation/-r

指定されたその他のオプションに基づいてボリュームをグループ化します。たとえば、--familyオプションを指定している場合は、指定したメディア・ファミリに属するボリュームを基準にしてソートが行われます。

--members/-m

表示される各ボリュームのボリューム・セット・メンバーがすべて表示されます。このオプションはデフォルトです。

--duplicates/-d

ボリューム自体と、そのボリュームの複製をリストします。

--noheader/-H

ヘッダー出力なしで情報が表示されます。

--contents/-c

各ボリュームのコンテンツに関する情報が表示されます。

このオプションを指定すると、例 2-77に示すように、バックアップ・セクションのサイズが表示されます。

--all/-a

ボリューム・カタログ内のすべてのボリュームが表示されます。

--vid/-v vid

ボリュームID vidを持つボリュームが表示されます。vidプレースホルダの詳細は、「vid」を参照してください。

--barcode/-b tag

バーコードtagを持つボリュームが表示されます。

--vset-/V vsetid

ボリューム・セットvsetidのメンバーであるボリュームが表示されます。vsetidは、ボリューム・セット内の最初のボリュームのvidを表します。vidプレースホルダの詳細は、「vid」を参照してください。

--dset/-D dsetid

複製セット内のすべての複製をリストします。複製セットIDは、オリジナル・ボリュームvidです。

--family/-f media-family-name

指定されたメディア・ファミリのすべてのボリュームが表示されます。media-family-nameプレースホルダは、mkmfまたはrenmfコマンドで割り当てられたメディア・ファミリの名前を表します。

--location/-C location-name[, location-name]…

指定した1つまたは複数の場所のボリュームに表示を制限します。

--attribute/-A volume-attr

属性volume-attrを持つボリュームがすべて表示されます。このプレースホルダの有効な値は次のとおりです。

• expired

  期限切れのすべてのボリューム。

• unexpired

  有効なすべてのボリューム。

• open

  書込み用に開かれたすべてのボリューム。

• closed

  書込み用に閉じられたすべてのボリューム。

--oid/-o oid

指定したoidを持つボリュームが表示されます。oidプレースホルダの詳細は、「oid」を参照してください。

--novid/-n

ボリュームIDのないボリュームが表示されます。

--nobarcode/-N

バーコードのないボリュームが表示されます。

出力

表2-22で、lsvolコマンドの出力について説明します。

表2-22 lsvolの出力

列	意味
VOID	ボリュームのOracle Secure Backupカタログ識別子
OOID	複製ボリュームの元（親）のOracle Secure Backupカタログ識別子。複製ではないボリュームのVOIDと同一です。
Barcode	テープ・ケースに添付されたバーコード・ラベルのID
Volume sequence	ボリューム・セットにおけるテープの番号。
Media family	Oracle Secure Backupメディア・ファミリ名
Current location	テープが現在存在する場所
Label host	テープを最初にラベル付けしたメディア・サーバー
Size	バックアップ・セクションのサイズ。
Created	ボリュームに最初に書込みが行われた日付。
Closes	テープへの書込みが可能な最終時間
Expires	テープの期限が切れ、上書きまたは強制的なラベル付け解除を実行して再利用できる日付
Space remaining	テープに残存する記憶容量

lsvolでレポートされる日付が6か月より前の過去または2か月より後の未来の場合は、yyyy/mm/ddの書式でレポートされます。日付が6か月以内の過去および2か月以内の未来の場合は、mm/dd.hh:mmの書式でレポートされます。

注意: 各バックアップIDは、バックアップの時間順に関係なくを割り当てられます。たとえば、バックアップID 25が月曜日のバックアップを示し、バックアップID 6が次の日のバックアップを示すことがあります。

例

例2-76 ライブラリ内のボリュームの表示

この例では、テープ・ライブラリlib1のボリュームを表示します。サンプル出力はページに収まるようにあらかじめ折り返されています。

ob> lsvol --long --library lib1
Inventory of library lib1:
    in    mte:           vacant
    in    1:             volume VOL000002, barcode ADE201, oid 110, 16962752 kb remaining
    in    2:             volume VOL000001, barcode ADE203, oid 102, 17619328 kb remaining
    in    3:             vacant
    in    4:             vacant
    in    iee1:          vacant
    in    iee2:          vacant
    in    iee3:          vacant
    in    dte:           volume RMAN-DEFAULT-000002, barcode ADE202, oid 112, 17017984 kb
                         remaining, content manages reuse, lastse 3

例2-77 ボリュームのコンテンツの表示

この例では、ボリュームOSB-CATALOG-MF-000325のコンテンツを表示しています。サンプル出力はページに収まるようにあらかじめ折り返されています。

ob> lsvol --contents --vid OSB-CATALOG-MF-000325
  VOID  OOID  Seq  Volume ID               Barcode   Family          Created
   231   231    1  OSB-CATALOG-MF-000325   NEDC2491  OSB-CATALOG-MF  10/07.21:03
     Attributes    BSOID  File Sect  Level  Host     Size        Created
     never closes  532    1    1     0      osbsvr3  62.4 MB     10/07.21:03
     Attributes