バージョン 8.1.3
 —  ユーティリティ  —

RESTORE:オフラインソースからの データベースのリストア

RESTORE 機能では、Adabas ニュークリアスがアクティブでないときに作成されたデータベースの SAVE データセットから、データベースをリストアします。

注意:

  1. RESTORE(データベース)処理が途中で中断した場合、その再実行は最初から行う必要があります。 処理を正常に終了するかまたはリストア処理を再実行するまで、データベースはアクセスできません。
  2. ADASAV RESTORE(データベース)のジョブ制御内に DDWORKnn/WORKnn の DD 名、記号名、またはリンク名が存在している場合、これらのデータセットはリセットされます。

このドキュメントでは、次のトピックについて説明します。


条件

Start of instruction setRESTORE(データベース)機能を使用する場合は、次の条件が満たされている必要があります。

  1. 正しい SAVE データセットを指定しなければなりません。 RESTORE に使用したものと同じバージョンの Adabas を使用して、オフラインのデータベース SAVE 操作によって作成されたものである必要があります。

  2. 出力データベースは元のデータベースと同じ物理レイアウト(デバイスタイプ、エクステントサイズ)でなければなりません。 アソシエータおよびデータストレージのデータセットは事前にフォーマットされたものが存在していなければなりません。 リストアする SAVE データセットはこのデータベースまたは異なるデータベースから作成されたものでもかまいません。

  3. 出力データベース、または出力データベースの DBID と一致するデータベースの Adabas ニュークリアスがアクティブであってはいけません。

  4. SAVE 処理が DRIVES パラメータを指定して実行された場合、作成された SAVE データセットのリストアでも DRIVES パラメータを指定できます。 そのとき、リストア処理は異なる SAVE データセットと並行して実行されます。 あるいは、その SAVE データセットを、DRIVES パラメータなしでリストアされる 1 つの SAVE データセットに連結することができます。

Top of page

結果

この機能を実行すると、データベースの物理ステータスが ADASAV SAVE 処理時と同じになります。

Top of page

構文

graphics/util_adasav_restore.png

Top of page

オプションパラメータ

BUFNO:ドライブごとのバッファカウント

BUFNO 値に DRIVES パラメータ値を掛けたものが RESTORE 機能に対する固定割り当てバッファとなります。 通常、2 または 3 の値で最適なパフォーマンスが得られ、255 まで指定可能です。 ただし、5 を超える値を指定してもパフォーマンスが大きく向上することはなく、大量のスペースを割り当てることになります。 デフォルトは 1(1 ドライブ当たり 1 バッファ)です。

CLOGDEV:コマンドログデバイスタイプ

デュアル/マルチコマンドログ(CLOG)に割り当てるデバイスタイプを指定します。 このパラメータは、CLOG に使用されるデバイスタイプが ADARUN DEVICE パラメータの指定と異なる場合にのみ必要です。

DRIVES:並行リストア用のテープドライブ

DRIVES は並行するリストア処理で使用するテープドライブの数を指定します。 1 から 8 までの数が指定可能であり、デフォルトは 1 です。

EXCLUDE:指定したファイルをリストアから除外

EXCLUDE は、リストアオペレーションから除外するファイル(リストアされないファイル)の番号をリストします。 データベースリストアでは、

このパラメータは省略可能です。指定しなかった場合、ファイルは一切除外されません。 ファイル番号は 1 度だけリスト可能です。

EXCLUDE パラメータは、Adabas Recovery Aid(ADARAI)によって構築されたリカバリジョブで使用するためのパラメータです。

NEWDBID:リストアするデータベースの新規 ID

NEWDBID は、リストアするデータベースに対して新たに異なるデータベース ID を割り当てる場合に使用します。 ID には 1~65,535 の範囲の数値を使用できます。Adabas Online System Security を導入した場合、DBID 999 は予約されます。

NEWDBID を指定する場合には ADARUN DBID パラメータで SAVE データセット上のデータベース ID を指定しなければなりません。

NEWDBID で指定された DBID の Adabas ニュークリアスは、アクティブであってはいけません。

NEWDBNAME:新データベース名

NEWDBNAME は、リストア対象データベースに対して新たな名前を割り当てる場合に使用します。 NEWDBNAME が省略された場合には、リストア対象データベースに元の名前がそのまま使用されます。

NOUSERABEND:アベンドなし終了

機能の実行中にエラーになると、ユーティリティは、エラーメッセージを出力してユーザーアベンド 34(ダンプあり)またはユーザーアベンド 35(ダンプなし)で終了します。

NOUSERABEND を指定すると、ユーティリティは、エラーメッセージを出力してもアベンドしません。 代りに、メッセージ "utility TERMINATED DUE TO ERROR CONDITION"(エラーのためユーティリティを終了します)を表示してコンディションコード 20 で終了します。

OVERWRITE:既存データベースの上書き

リストア処理で既存のデータベースを上書きする場合、OVERWRITE パラメータを指定する必要があります。

上書きされるデータベースの Adabas ニュークリアスは、アクティブであってはいけません。

PLOGDEV:プロテクションログのデバイスタイプ

デュアル/マルチプロテクションログ(PLOG)のデバイスタイプを指定します。 このパラメータは、PLOG のデバイスタイプが ADARUN DEVICE パラメータの指定と異なる場合にのみ必要です。

TEST:構文テスト

TEST パラメータは、処理を実際には行わずに構文のみをテストします。 指定したパラメータの構文だけがテストされ、値や変数の正当性はテストされません。

Top of page

例 1

ADASAV RESTORE OVERWRITE

データベースがリストアされます。 既存のデータベースが上書きされる場合があります。

例 2

ADASAV RESTORE EXCLUDE=10,11,12

オフラインのセーブデータセットからのデータベースのリストアでファイル 10~12 が除外されます。

Top of page