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

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

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

注意:

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

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


条件

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

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

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

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

  4. SAVE 処理(SAVE 実行の出力参照)実行時のニュークリアスセッション中に作成された情報を含むプロテクションログ(PLOG)データセットを指定しなければなりません。 他のセッションで作成された PLOG データセットも組み込むことができます。

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

Top of page

結果

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

Top of page

構文

graphics/util_adasav_restonl.png

Top of page

オプションのパラメータとサブパラメータ

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

BUFNO 値に DRIVES パラメータ値を掛けたものが RESTONL 機能に対する固定割り当てバッファとなります。 通常、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 パラメータの指定と異なる場合にのみ必要です。

PLOGNUM:プロテクションログ番号

PLOGNUM は、ADASAV SAVE のアクティブ時に使用したニュークリアスプロテクションログの番号を指定します(オンライン SAVE 機能の出力リスト参照)。 複数のニュークリアスセッションのシーケンシャルプロテクション(SIBA)ログは、連結できます。 ADASAV は、PLOGNUM 値よりも小さい番号をもったプロテクションログをスキップします。 PLOGNUM の指定は任意です。

PLOGNUM を指定しない場合、ADASAV は SAVE データセットに格納された情報から正しい値を自動的に決定します。

SYN1:開始ブロック番号

SYN1 は、対応する SAVE 処理を開始する SYN1 チェックポイントが含まれるブロック番号を指定します。オンライン SAVE 機能の出力リストを参照してください。 このパラメータは任意指定です。

SYN1 を指定しない場合、ADASAV は SAVE データセットに格納された情報から正しい値を自動的に決定します。

TEST:構文テスト

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

Top of page

例 1

ADASAV RESTONL

ニュークリアスがアクティブな状態(オンライン)でセーブされたデータベースをリストアします。 リストア処理に必要なプロテクションログ番号および SYN1 ブロック番号は、ADASAV によって自動的に決定されます。

例 2

ADASAV RESTONL
ADASAV EXCLUDE=255
ADASAV EXCLUDE=400

オンラインセーブデータセットから行うデータベースのリストアからファイル 255 と 400 を除外します。

Top of page