REORFILE 機能は、1 つのファイルに対してアソシエータおよびデータストレージをリオーダします。 他のファイルのアソシエータおよびデータストレージは影響を受けません。
この機能は、オペレーション時に使用されるデータベースファイルに対して EXF 排他制御を必要とします。 また、ADAORD の実行中に、データベースは部分的に上書きされます。したがって、ADAORD 機能を実行する前にデータベース(またはファイル)を ADASAV ユーティリティでバックアップしておいてください。
この機能に指定されたファイルがもともと ISNREUSE=YES がアクティブな状態でロードされていた場合、このリオーダ機能は、そのファイルのファイルコントロールブロック(FCB)内の最初の未使用 ISN 値をアドレスコンバータ内で最初に検出された実際の未使用 ISN にリセットします。
次に、ADAORD REORFILE 機能の構文を示します。
このドキュメントでは、次のトピックについて説明します。
FILE は、処理対象となり、後続ステートメント内のパラメータが適用されるファイルを指定します。 複数のファイルおよび関連するパラメータを 1 回の REORFILE 操作で指定できます。例については、このセクションの最後を参照してください。 ADABAS 拡張ファイルのコンポーネントファイルを指定した場合、そのファイルのアソシエータおよびデータストレージのみがリオーダされ、他のコンポーネントファイルには悪影響を与えません。
ACRABN は、ファイルのアドレスコンバータエクステントの開始 RABN を指定します。 このパラメータ指定がなければ、ADAORD が開始 RABN を割り当てます。 要求されたスペースは、1 つのエクステントで使用できる必要があります。
アソシエータエクステントの開始 RABN を指定するときは、FCB、FDT および DSST に必要なスペースも考慮する必要があります。
ファイルのセカンダリアドレスコンバータエクステントの開始 RABN です。 セカンダリアドレスコンバータは、セカンダリスパンドレコードのセカンダリ ISN を、セカンダリレコードが格納されているデータストレージブロックの RABN にマッピングするために使用されます。
このパラメータ指定がなければ、ADAORD が開始 RABN を割り当てます。 要求されたスペースは、1 つのエクステントで使用できる必要があります。 ファイルにセカンダリアドレスコンバータエクステントが含まれていない場合、このパラメータは無視されます。
ALLOCATION は、配置パラメータ ACRABN、DSRABN、NIRABN または UIRABN に従ってファイルエクステント割り当てが得られない場合に取るべき動作を指定します。
デフォルト(すなわち ALLOCATION=FORCE)の場合は、RABN 配置パラメータに従ったファイルエクステント割り当てができないと、このユーティリティはエラーで終了します。
ALLOCATION=NOFORCE の場合は、配置パラメータによる割り当てができないと、配置パラメータなしで再度割り当てようとします。
ASSOPFAC は、新アソシエータブロックパディングファクタを指定します。 指定値は、リオーダ処理時に使用しない各アソシエータブロックのパーセントを表します。 1 から 90 の値が指定できます。 パディング後に残っているバイト数は、最大ディスクリプタ値に 10 を加えたものより大きくなければなりません。
このパラメータ指定がなければ、現在ファイルに有効なアソシエータパディングファクタが使用されます。
注意:
ASSOVOLUME 値は単一引用符でくくらなければなりません。
ASSOVOLUME は、ファイルのアソシエータスペース(AC、NI、UI エクステント)を割り当てるボリュームを指定します。 要求スペースが指定ボリュームに存在しないと、ADAORD は、デフォルト割り当てルールに従って、他ボリュームの残りのブロックを割り当てます。
ACRABN、UIRABN、または NIRABN が指定されていると、ADAORD は、該当するエクステントタイプを割り当てるときに、ASSOVOLUME を無視します。
ASSOVOLUME を指定しないと、ファイルのアソシエータスペースは、ADAORD のデフォルト割り当てルールに従って割り当てられます。
DATAPFAC は、新データストレージパディングファクタを指定します。指定値は、リオーダ処理時レコード拡張のために確保される各データストレージブロックのパーセントを表します。 1 から 90 までの範囲の値が指定できます(パディングファクタの設定の詳細については ADALOD LOAD DATAPFAC パラメータに関する説明を参照してください)。 このパラメータ指定がなければ、ファイルに対して現在有効なパディングファクタが使用されます。
注意:
DATAVOLUME パラメータは単一引用符でくくらなければなりません。
ファイルのデータストレージスペースエクステントを割り当てるときに使用するボリューム番号を指定します。 DSSIZE で要求されたブロックの数が指定ボリュームに存在しないと、ADAORD はデフォルト割り当てルールに従って、他ボリュームの残りのブロックを割り当てます。
DSRABN を指定した場合、関連ファイルに対する DATAVOLUME は無視されます。
DATAVOLUME が指定されない場合、データストレージスペースは、ADAORD のデフォルト割り当てルールに従って、割り当てられます。
DSDEV は、ファイルのデータストレージに対して使用されるデバイスタイプを指定します。 指定デバイスタイプは、通常、そのデータベースの作成時か、あるいは ADADBS ユーティリティの ADD 機能によって、すでに Adabas に対して定義されているものでなければなりません。
このパラメータを指定しないと、ADAORD はリオーダ前に使用されていたデバイスタイプでファイルを割り当てようとします。
DSRABN は、ファイルのデータストレージエクステントの開始 RABN を指定します。 DSRABN を省略すると、開始 RABN が割り当てられます。
DSRELEASE を指定することで、ファイルに属する未使用のデータストレージ(DS)ブロックが解放されます。 DSRELEASE が指定されない場合には、少なくともそのファイルがリオーダされる以前に割り当てられた DS ブロック数が ADAORD によって割り当てられます。
注意:
Adabas
は、あらゆる変更されたパディングファクタまたはファイルがリオーダされる前のブロックサイズ値を用いてファイルのエクステントサイズを計算します。
DSSIZE は、データストレージに対して割り当てられるブロック数またはシリンダ数を指定します。 ブロック単位で指定する場合には、値の後に "B" を指定する必要があります("2000B" など)。
このパラメータが省略されると、そのファイルのエクステントサイズは DATAPFAC パディングファクタ内での全増減に比例して ADAORD によって計算されます。
EXCLUDE は、REORDER 処理から除外されるファイル(つまりリオーダされないファイル)をリストします。
このパラメータは省略可能です。指定しなかった場合、ファイルは一切除外されません。 ファイル番号は 1 度だけリスト可能です。
EXCLUDE パラメータで指定されるファイルは、FILE パラメータでも指定する必要があります。
EXCLUDE パラメータは、Adabas Recovery Aid(ADARAI)によって構築されたリカバリジョブで使用するためのパラメータです。
INDEXCOMPRESSION は、ファイルが圧縮形式または非圧縮形式で再構成されるかどうかを示します。 通常、インデックスを圧縮すると、インデックススペースが少なくなり、Adabas ニュークリアスのインデックス操作の効率が向上します。
INDEXCOMPRESSION を指定しない場合、ファイルの現在の形式がデフォルトになります。
ISNSIZE はファイル内の ISN 長が 3 バイトであるか 4 バイトであるかを指定します。 デフォルトはファイルに使用された現在の値です。この値はファイルコントロールブロック(FCB)内に格納されます。
注意:
物理的にカップリングされているファイルの ISNSIZE を ADAORD で変更することはできません。
LIP パラメータは、アドレスコンバータの再作成時のアソシエータの入出力処理の回数を減少させるために使用できます。 処理対象となる中で一番規模が大きいファイルの全 ISN を受け入れるだけの大きさを指定したときに最適のパフォーマンスとなります。
ISN と割り当てられたデータストレージ RABN を入れるための ISN プールサイズを指定します。 値はバイト単位で指定し、数値のみ("2048" など)を指定するか、あるいは数値の後に "K" を付けて("2K" など)キロバイト単位で指定します。 LIP のデフォルトは 16384 バイト(または 16K)です。
1 件の入力レコード長は、ISNSIZE + RABNSIZE です。 したがって、エントリ長は、最小 6 バイト(ファイルの ISNSIZE が 3 でデータベースの RABNSIZE が 3 の場合)、最大 8 バイト(ISNSIZE が 4 で RABNSIZE が 4 の場合)になります。
LPB は、内部プリフェッチバッファの大きさをバイト単位で指定するものです。 指定可能な最大値は、32,760 バイトです。 デフォルトは、ADARUN LU パラメータの指定に依存します。 LU 値が小さすぎる場合には、LPB 値が指定値よりも小さくなることがあります。
MAXISN は、ファイルに対して割り当てる最大 ISN を指定します。 この値は、ADAREP データベースレポートに出力される現在の TOPISN より大きい必要があります。
指定された値は、ADAORD によりアドレスコンバータスペース必要量の計算に使用されます。 このパラメータが省略されると、ファイルに対する現在の MAXISN 値が保持されます。
MAXISN は、ISN 内のセカンダリアドレスコンバータ(AC2)のサイズを指定します。 この値は、ADAREP データベースレポートに出力される現在の TOP AC2 ISN より大きい必要があります。 セカンダリアドレスコンバータは、セカンダリスパンドレコードのセカンダリ ISN を、セカンダリレコードが格納されているデータストレージブロックの RABN にマッピングするために使用されます。
ADAORD は、ファイルのセカンダリアドレスコンバータで必要なスペースを計算するために指定された値を使用します。 このパラメータが省略されると、ファイルに対する現在の MAXISN2 値が保持されます。 ファイルにセカンダリアドレスコンバータエクステントが含まれていない場合、このパラメータは無視されます。
ファイルの最大圧縮レコード長の制限を変更するには、MAXRECL パラメータを使用します。 MAXRECL を指定すると、次の 2 つの効果があります。
ファイルの DATA データセットは、指定された長さをサポートするデバイスに対してのみ割り当てられます。
指定された長さを超えるデータストレージレコードがファイル内に含まれている場合、ADAORD は異常終了し、ERROR-126 メッセージ(データストレージレコードが長すぎる)を出力します。
MAXRECL を指定しなければ、最大圧縮レコード長は変更されません。
NIRABN は、ノーマルインデックスエクステントの開始 RABN を指定します。 このパラメータ指定がなければ、ADAORD が開始 RABN を割り当てます。
NIRELEASE が指定されると、ファイルに属する未使用のノーマルインデックス(NI)が解放されます。 NIRELEASE が指定されない場合には、少なくともそのファイルがリオーダされる以前に割り当てられた NI ブロックが ADAORD により割り当てられます。
注意:
Adabas
は、あらゆる変更されたパディングファクタまたはファイルがリオーダされる前のブロックサイズ値を用いてファイルのエクステントサイズを計算します。
NISIZE は、ファイルのノーマルインデックスに対して割り当てるブロック数またはシリンダ数を指定します。 ブロック単位で指定する場合には、値の後に "B" を指定する必要があります("2000B" など)。
このパラメータが省略されると、そのファイルのエクステントサイズは ASSOPFAC パディングファクタ内での全増減に比例して ADAORD によって計算されます。
機能の実行中にエラーになると、ユーティリティは、エラーメッセージを出力してユーザーアベンド 34(ダンプあり)またはユーザーアベンド 35(ダンプなし)で終了します。
NOUSERABEND を指定すると、ユーティリティは、エラーメッセージを出力してもアベンドしません。 代りに、メッセージ "utility TERMINATED DUE TO ERROR CONDITION"(エラーのためユーティリティを終了します)を表示してコンディションコード 20 で終了します。
ファイルがパスワード保護されている場合、このパラメータを使用してパスワードを指定します。
SORTSEQ は、ファイルを処理する順番を指定します。 このパラメータを省略すると、レコードが物理順で処理されます。
ディスクリプタを指定すると、ファイルがディスクリプタ値の論理順で処理されます。 空値省略されたディスクリプタフィールド、ハイパーディスクリプタ、フォネティックディスクリプタ、マルチプルバリューフィールド、またはピリオディックグループ内のディスクリプタは指定してはなりません。
注意:
ディスクリプタフィールドまたは後続のフィールドが初期化されていない(値を持たない)場合は、空値省略されたディスクリプタフィールドでなくても、そのレコードはインバーテッドリストに含まれません。
したがって、そのレコードはユーティリティの実行時に除外されます。
ISN を指定すると、ファイルが ISN 昇順に処理されます。 また、Adabas チェックポイントまたはセキュリティファイルについては、SORTSEQ=ISN しか許可されません。
このパラメータは、実際に処理を行わずに構文をテストします。 指定したパラメータの構文だけがテストされ、値や変数の正当性はテストされません。
UIRABN は、ファイルのアッパーインデックスエクステントの開始 RABN を指定します。 このパラメータ指定がなければ、ADAORD が開始 RABN を割り当てます。
UIRELEASE が指定されると、ファイルに属する未使用のアッパーインデックス(UI)が解放されます。 UIRELEASE が指定されない場合には、少なくともそのファイルがリオーダされる以前に割り当てられた UI ブロックが ADAORD により割り当てられます。
注意:
Adabas
は、あらゆる変更されたパディングファクタまたはファイルがリオーダされる前のブロックサイズ値を用いてファイルのエクステントサイズを計算します。
UISIZE は、アッパーインデックスに対して割り当てるブロック数またはシリンダ数を指定します。 ブロック単位で指定する場合には、値の後に "B" を指定する必要があります("2000B" など)。
このパラメータが省略されると、そのファイルのエクステントサイズは ASSOPFAC パディングファクタ内での全増減に比例して ADAORD によって計算されます。
ADAORD REORFILE FILE=16
ファイル 16 のアソシエータおよびデータストレージをリオーダします。 ファイルの現在のエクステントサイズおよびパディングファクタはすべて保持されます。 他のファイルはリオーダされません。
ADAORD REORFILE FILE=246 ADAORD DATAPFAC=5,DSSIZE=10B,SORTSEQ=MZ ADAORD ASSOPFAC=20,MAXISN=5000 ADAORD FILE=20
ファイル 246 をリオーダします。他のファイルのアソシエータおよびデータストレージは変更されません。 データストレージパディングファクタは 5 にセットします。 10 個のシリンダの新しいデータストレージサイズを使用します。 データストレージをディスクリプタ MZ の論理順にリオーダします。 新しいアソシエータパディングファクタは 20 です。 指定可能な最大 ISN は 5000 です。 現在のパラメータに変更を加えずに、ファイル 20 をリオーダします。
ADAORD REORFILE FILE=9 ADAORD ASSOPFAC=5,DATAPFAC=15 ADAORD FILE=23 ADAORD DSRABN=24032 ADAORD UIRABN=3151,UISIZE=50B ADAORD NIRABN=3201
ファイル 9 および 23 のアソシエータをリオーダします。他のファイルは変更されません。
ファイル 9、10、および 12 のアソシエータパディングファクタは 5 %にセットし、データストレージパディングファクタは 15 %にセットします。 ファイル 23 の新しいデータストレージ開始 RABN は 24032 です。 また、ファイル 23 のアッパーインデックスの新しい開始 RABN を 3151、そのサイズを 50 ブロックに変更します。 ノーマルインデックスの新しい開始 RABN は 3201、そのサイズは変更前と同じです。