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

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

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

注意:

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

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


条件

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

  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 データセットに連結することができます。

  6. マルチボリュームデータベースの SAVE データセットからほんのわずかのファイルをリストアする場合、リストアするファイルのデータを実際に含むテープボリュームだけを ADASAV ジョブ制御に指定する必要があります。 対応する SYNV チェックポイントと同様に SAVE 処理のジョブプロトコルは各ボリュームに含まれるファイルまたはファイル群の一部を示します。

Top of page

結果

この機能を実行すると、データベースには、指定されたファイル、チェックポイントファイル、およびセキュリティファイルが格納されます。これらのファイルの物理ステータスは ADASAV SAVE 処理終了時と同じになります。

この処理は、RESTONL(データベース)と同等です。ただし、FILES パラメータに指定されていないファイルは除外されます。

重要:
ターゲットアソシエータおよびデータストレージデータセット内の既存のデータベースは完全に上書きされ、そのデータベース内のファイルはすべて失われます。

Top of page

構文

graphics/util_adasav_restonl_gcb.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 は、リストアオペレーションから除外するファイル(リストアされないファイル)の番号をリストします。

EXCLUDE パラメータに指定されたファイルはリストアデータベースには含まれません。

EXCLUDE パラメータに指定されたすべてのファイルがセーブデータセット上に存在している必要があります。

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

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

FILES:リストア対象ファイル

FILES は、データベースリストア処理に含まれるファイル(群)を指定します。 チェックポイントファイルとセキュリティファイル(存在する場合)は常にリストアされます。 指定ファイルが Adabas 拡張ファイルのコンポーネントファイルである場合、拡張ファイルの全コンポーネントファイルも指定しなければなりません。 指定されたファイルが他のファイルとカップリングされている場合、カップリングされている他方のファイルも指定しなければなりません。

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 GCB

ニュークリアスがアクティブだった(オンライン)ときにセーブされたデータベース GCB がリストアされます。 チェックポイントファイルとセキュリティファイルもリストアされます。 リストア処理を自動的に行うために必要なプロテクションログ番号と SYN1 ブロック番号が ADASAV によって決定されます。

例 2

ADASAV RESTONL   GCB,FILES=3,4,5,OVERWRITE
ADASAV          PLOGNUM=15,SYN1=20

ファイル 3、4、5 が、チェックポイントファイルやセキュリティファイルとともにリストアされます。 プロテクションログ番号は 15、SYN1 チェックポイントが含まれるブロックは 20 です。 元のデータベースは上書きされます。

Top of page