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

RESTRUCTUREF:個別のファイルの再構築

RESTRUCTUREF 機能は、1 つ以上のファイルをシーケンシャルデータセットにアンロードします。このデータセットを STORE 機能の入力として使用し、ファイルを別のデータベースにロードすることができます。 ターゲットデータベースは、元のデータベースと異なる物理デバイスタイプにあってもかまいません。 アソシエータおよびデータストレージは RESTRUCTURE/STORE 処理の一部としてリオーダされます。

RESTRUCTUREF では EXU 制御が必要であり、他ユーザーに対して対象となっているデータベースファイルの読み込みだけのアクセスを認めます。 ただし、チェックポイントファイルまたはセキュリティファイルに関係する操作では、データベースに対して排他制御を必要とすることに注意してください。 また、ADAORD の実行中に、データベースの一部が上書きされます。 したがって、ADAORD 機能を実行する前にデータベース(またはファイル)を ADASAV ユーティリティでバックアップしておいてください。

この機能に指定されたファイルがもともと ISNREUSE=YES がアクティブな状態でロードされていた場合、このリオーダ機能は、そのファイルのファイルコントロールブロック(FCB)内の最初の未使用 ISN 値をアドレスコンバータ内で最初に検出された実際の未使用 ISN にリセットします。

RESTRUCTUREF 機能 でオーバーフローエリアを使用する ADAM ファイルを再構築した後、STORE 機能を使用して、DATA の小さいデータベースに再構築されたファイルを格納すると、ADAORD ERROR-103 が発生することがあります。 代わりに、ADAULD および ADALOD ユーティリティを使用して ADAM ファイルを移動します。

注意:
ADAORD STORE を使用すると、Adabas 8 以前のバージョンのデータベースやファイルを再構築して、Adabas 8 データベースに格納できます。 ただし、再構築した Adabas 8 データベース出力、または Adabas 7 などの以前のバージョンで実行中のデータベースに含まれるファイルは、格納できません。

次に、ADAORD RESTRUCTUREF 機能の構文を示します。

graphics/util_adaord_ref.png

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


基本パラメータ

FILE:ファイル番号

FILE は、再構築するファイルを指定します。 処理するファイルごとに別個の ADAORD FILE ステートメントを指定し、そのファイルの関連パラメータを含む ADAORD ステートメントを続けて指定する必要があります。

カップリングされているファイルまたは拡張ファイルの一部であるファイルを指定すると、関連ファイルが自動的にファイルリストに追加されます。 ファイルが追加されたことを示すメッセージは DDPRINT に出力されます。

Top of page

オプションパラメータ

ASSODEV:アソシエータデバイスタイプ

ASSODEV は、指定ファイルの新しい ASSO データセットに使用するデバイスタイプを指定します。 このパラメータは、使用するデバイスタイプがデフォルトのデバイスタイプと異なる場合にのみ必要となります。 デフォルトのデバイスタイプは、DBASSODEV パラメータ値となります。DBASSODEV を指定しなければ、ADARUN DEVICE パラメータによって指定されたデバイスタイプがデフォルトとなります。 これらのパラメータは、DDFILEA/FILEA データセットに書かれるデータには影響を及ぼしません。

ASSOPFAC:アソシエータパディングファクタ

ADAORD は、ASSOPFAC 値を使用して、指定ファイルの STORE 機能の実行に必要なスペースを計算します。 有効な値の範囲は 1~90 です。 ASSODEV によって指定されたデバイスタイプおよび ASSOPFAC によって指定されたパディングファクタにより AC、NI、UI ブロック数を計算します。 ASSOPFAC を指定しなければ、ファイルの現在のパディングファクタが使用されます。 これらのパラメータは、DDFILEA に書かれたデータには影響を及ぼしません。

DATADEV:データストレージデバイスタイプ

DATADEV は指定ファイルの新 DATA データセットに使用するデバイスタイプを指定します。 このパラメータは、使用するデバイスタイプがデフォルトのデバイスタイプと異なる場合にのみ必要となります。 デフォルトのデバイスタイプは、DBDATADEV パラメータ値となります。DBDATADEV を指定しなければ、ADARUN DEVICE パラメータによって指定されたデバイスタイプがデフォルトとなります。 これらのパラメータは、DDFILEA に書かれたデータには影響を及ぼしません。

DATAPFAC:データストレージパディングファクタ

ADAORD は指定ファイルの STORE 機能の実行に必要なスペースを計算するために DATAPFAC を使用します。 1~90 の範囲の値が指定できます(パディングファクタの設定についての詳細は、ADALOD LOAD DATAPFAC パラメータに関する説明を参照してください)。 DATADEV によって指定されたデバイスタイプおよび DATAPFAC によって指定されたパディングファクタによりデータストレージブロック数を計算します。 DATAPFAC を指定しなければ、ファイルの現在のパディングファクタが使用されます。 これらのパラメータは、DDFILEA に書かれたデータには影響を及ぼしません。

DBASSODEV:アソシエータに対するデフォルトデバイスタイプ

DBASSODEV は新 ASSO データセットのデフォルトデバイスタイプを指定します。 ADAORD はリストラクチャされた各ファイルの ASSO スペース必要量を計算するときに、このパラメータに指定されたデバイスタイプを使用します。 DBASSODEV を指定しなければ、ADARUN DEVICE パラメータによって指定されたデバイスタイプがデフォルトとなります。

ファイルのデフォルトデバイスタイプを変更するときは、FILE および ASSODEV パラメータを使用します。

DBDATADEV:データストレージに対するデフォルトデバイスタイプ

DBDATADEV は新 DATA データセットのデフォルトデバイスタイプを指定します。 ADAORD はリストラクチャされた各ファイルの DATA スペース必要量を計算するときに、このパラメータに指定されたデバイスタイプを使用します。 DBDATADEV を指定しなければ、ADARUN DEVICE パラメータによって指定されたデバイスタイプがデフォルトとなります。

ファイルのデフォルトデバイスタイプを変更するときは、FILE および DATADEV パラメータを使用します。

INDEXCOMPRESSION:ファイルのインデックスサイズの計算

INDEXCOMPRESSION は、指定ファイルに対するインデックススペースの計算と表示を圧縮形式または非圧縮形式のいずれで行うかを指定します。

INDEXCOMPRESSION を指定せず

ISNSIZE:3 または 4 バイト ISN

ISNSIZE はファイル内の ISN 長が 3 バイトであるか 4 バイトであるかを指定します。 デフォルトはファイルに使用された現在の値です。この値はファイルコントロールブロック(FCB)内に格納されます。

注意:
物理的にカップリングされているファイルの ISNSIZE を ADAORD で変更することはできません。

LPB:プリフェッチバッファサイズ

LPB は、内部プリフェッチバッファの大きさをバイト単位で指定するものです。 最大サイズは 32,760 バイトです。 デフォルトは、ADARUN LU パラメータの指定に依存します。 LU 値が小さすぎる場合には、LPB 値が指定値よりも小さくなることがあります。

NOUSERABEND:アベンドなし終了

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

NOUSERABEND を指定すると、ユーティリティは、エラーメッセージを出力してもアベンドしません。 代わりに、メッセージ v が表示され、ユーティリティはコンディションコード 20 で終了します。

PASSWORD:ファイルパスワード

ファイルがパスワード保護されている場合、このパラメータを使用してパスワードを指定します。

SORTSEQ:ファイルの処理順序

SORTSEQ は、ファイルを処理する順番を指定します。 このパラメータを省略すると、レコードが物理順で処理されます。

ディスクリプタを指定すると、ファイルがディスクリプタ値の論理順で処理されます。 空値省略されたディスクリプタフィールド、ハイパーディスクリプタ、フォネティックディスクリプタ、マルチプルバリューフィールド、またはピリオディックグループ内のディスクリプタは指定してはなりません

注意:
ディスクリプタフィールドまたは後続のフィールドが初期化されていない(値を持たない)場合は、空値省略されたディスクリプタフィールドでなくても、そのレコードはインバーテッドリストに含まれません。 したがって、そのレコードはユーティリティの実行時に除外されます。

ISN を指定すると、ファイルが ISN 昇順に処理されます。 また、Adabas チェックポイントまたはセキュリティファイルについては、SORTSEQ=ISN しか許可されません。

TEST:構文テスト

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

Top of page

例 1

ADAORD RESTRUCTUREF FILE=15                          

RESTRUCTUREF 機能を実行します。 ファイル 15 を物理順にアンロードします。 他ファイルはアンロードされません。

例 2

ADAORD RESTRUCTUREF  FILE=25,SORTSEQ=KL
ADAORD               FILE=40,SORTSEQ=J3                           

RESTRUCTUREF 機能を実行します。 ファイル 25 および 40 をアンロードします。 ファイル 25 をディスクリプタ KL の順にアンロードします。 ファイル 40 をディスクリプタ J3 の順にアンロードします。 他ファイルはアンロードされません。

Top of page