CHECK INDEX 制御ステートメントの構文とオプション

CHECK INDEX ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。

制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。

構文図

>>-CHECK--INDEX------------------------------------------------->

>--+-LIST--listdef-name------------------------------------------------------------+-->
   +-(-index-name--+---------------+-)---------------------------------------------+   
   |               '-PART--integer-'                                               |   
   '-(--ALL--)--TABLESPACE--+----------------+-table-space-name--+---------------+-'   
                            '-database-name.-'                   '-PART--integer-'     

              .-SHRLEVEL--REFERENCE-.   
>--+-------+--+---------------------+--------------------------->
   '-CLONE-'  '-SHRLEVEL--CHANGE----'   

   .-DRAIN_WAIT--IRLMRWT value-.  .-RETRY--UTIMOUT value-.   
>--+---------------------------+--+----------------------+------>
   '-DRAIN_WAIT--integer-------'  '-RETRY--integer-------'   

>--+----------------------+--+-----------------------+---------->
   '-RETRY_DELAY--integer-'  '-SORTDEVT--device-type-'   

                         .-PARALLEL--0------------.   
>--+------------------+--+------------------------+------------><
   '-SORTNUM--integer-'  '-PARALLEL--num-subtasks-'   

オプションの説明

INDEX
索引の整合性をチェックすることを示します。
LIST listdef-name
前に定義された LISTDEF リスト名の名前を指定し ます。リスに含まれているのは、索引スペースのみ です。索引または表スペースの名前を指定しないでください。Db2® は、索引をそれらと関連付けられた表スペース別にグループ化し、表スペースごとに 1 回ずつ CHECK INDEX を実行します。CHECK INDEX では、それぞれの制御ステートメントごとに 1 つの LIST キーワードを使用 できます。このユーティリティーは、CLONE キーワードが指定されている場合のみクローン・データを処理します。LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。

パーティションまたは パーティション範囲をリストに指定できます。

(index-name, …)
チェックすべき索引を指定します。 すべての索引は同じ表スペース内の表に属している必要があります。 このオプションを省略する場合は、(ALL) TABLESPACE オプションを使用する必要があります。 この場合、CHECK INDEX は、指定された表スペース内のすべての表の全索引を検査します。

index-name は、索引の名前であり、creator-id.name の形式です。 修飾子 creator-id を省略すると、 ユーティリティー・ジョブのユーザー ID が使用されます。 名前のリストを使用する場合は、リストの項目をコンマで区切ります。 名前または名前のリストを括弧で囲む必要があります。 名前にブランクが含まれている場合は、索引名を引用符で囲みます。

PART integer
整合性を検査する対象の、パーティション化索引の物理パーティション、または 非パーティション化索引の論理パーティションを指定します。 非パーティション化表スペースの索引を指定すると、エラーが発生します。

変更の始まりinteger は物理パーティション番号です。1 から、表スペースに定義されたパーティション数までの範囲でなければなりません。 最大は 4096 です。変更の終わり

PART キーワードが指定されていない場合は、CHECK INDEX はターゲット索引全体 の整合性をテストします。

(ALL)
指定された表スペース内の、その表スペースによって参照されているすべての索引を検査することを指定します。
TABLESPACE database-name.table-space-name
すべての索引のチェックが行われる表スペースを指定します。 索引名の明示リストが与えられていない場合は、 指定された表スペースのすべての表の全索引が検査されます。

TABLESPACE は、索引名の明示リストには指定しないでください。

database-name は、表スペースが属しているデータベースの名前です。デフォルト値は、DSNDB04 です。

table-space-name は、すべての索引が検査される表スペースの名前です。

CLONE
指定された索引のうちクローン表の索引のみを CHECK INDEX が検査する ことを指示します。このユーティリティーは、CLONE キーワードが指定されている場合のみクローン・データを処理します。LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。
SHRLEVEL
検査される索引、表スペース、またはパーティションに対して CHECK INDEX 処理中に許可されるアクセス のタイプを示します。
REFERENCE
アプリケーションが、検査される索引、表スペース、または パーティションの読み取りはできるが、書き込みはできないということを指定します。

SHRLEVEL REFERENCE が指定されるか、デフォルトでこの値が使用されると、Db2 は索引項目を アンロードし、索引項目をソートし、データをスキャンして索引項目を検証します。

CHANGE
アプリケーションが、検査される索引、表スペース、またはパーティションの読み取りと 書き込みをできるということを指定します。

SHRLEVEL CHANGE が指定されていると、Db2 は以下の アクションを実行します。

  • すべての書き込みプログラムをドレーンし、指定されたオブジェクトとそのすべての索引用に、 バッファーを強制的にディスクに書き込む。
  • DFSMSdss を 呼び出し、指定されたオブジェクトとそのすべての索引をシャドー・データ・セットにコピーする。
  • 指定されたオブジェクトとそのすべての索引のための読み取り/書き込みアクセスを使用可能にする。
  • シャドー・データ・セットで CHECK INDEX を実行する。

デフォルトでは、DFSMSdss は FlashCopy® を使って Db2 オブジェクトをシャドー・データ・セットにコピーします (FlashCopy が使用可能な場合)。 DFSMSdss で FlashCopy を使用できない場合、DFSMSdss はより低速な方法を使用します。 結果として、オブジェクトのコピーの作成に長い時間がかかり、データと索引が読み取り専用アクセスになる時間が増える可能性があります。 CHECK ユーティリティーに FlashCopy のみを強制的に使用させるために、CHECK_FASTREPLICATION サブシステム・パラメーターを REQUIRED に設定することができます。 FlashCopy が使用可能でない場合は CHECK ユーティリティーが失敗します。

DRAIN_WAIT integer
表スペースまたは索引をドレーンする際の CHECK INDEX の待ち時間を秒数で指定します。 指定された時間は、検査されるオブジェクトについて集約した時間です。 この値は、IRLMRWT および UTIMOUT サブシステム・パラメーターによって指定された値を オーバーライドします。

integer は 0 から 1800 まで任意の整数 です。DRAIN_WAIT が指定されていない場合、あるいは値 0 が指定された場合、CHECK INDEX は ロック・タイムアウト・サブシステム・パラメーター IRLMRWT の値を使用します。

RETRY integer
CHECK INDEX がオブジェクトのドレーンの試行を続行する最大回数を指定します。

integer は 0 から 255 まで任意の整数です。 0 以外の値が指定されていると、処理コストが増加し、 指定された索引、表スペース、またはパーティションが読み取り専用アクセスになる期間が、 長引いたり複数期間になってしまう恐れがあります。

RETRY を指定しない場合は、CHECK INDEX はユーティリティー乗数サブシステム・パラメーター の UTIMOUT を使用します。

RETRY_DELAY integer
オブジェクトのドレーンの再試行と再試行の間の最小期間 (秒) を指定します。 integer は 1 から 1800 まで任意の整数です。

RETRY_DELAY を指定しない場合は、CHECK INDEX は以下の 2 つの値の小さい方を使用します。

  • DRAIN_WAIT 値 × RETRY 値
  • DRAIN_WAIT 値 × 10
SORTDEVT device-type
外部ソート・プログラムによって動的に割り振られる一時データ・セットの装置タイプを指定します。ソート・プログラムの SORT または OPTION 制御ステートメントの DYNALLOC パラメーターで受け入れ可能なディスク装置タイプであれば、任意のタイプを指定できます。

TEMPLATE 指定では、ソート作業データ・セットの動的割り振りは行われません。 SORTDEVT キーワードが、これらのデータ・セットの動的割り振りを制御します。

device-type は装置タイプです。SORTDEVT を省略した場合で、ソートが必要な場合は、 ソート・プログラムが一時データ・セット用に必要とする DD ステートメントを指定しなければなりません。

SORTNUM integer
ソート・プログラムによって動的に割り振られる一時データ・セット数を 指定します。

integer は一時データ・セット数で、可能な 範囲は 2 から 255 です。

SORTDEVT を省略した場合、SORTNUM は無視され ます。SORTDEVT を使用し、SORTNUM を省略した場合、ソート・プログラムへは値は渡されません。ソート・プログラムでは、それ自体のデフォルトを使用します。

各ソートごとに最低 2 つのソート用作業データ・セットが必要です。SORTNUM 値は、このユーティリティー内の各ソート呼び出しに適用されます。例えば、CHECK INDEX で 3 つの索引を検査する場合に、並列処理を制限する制約が何もなく、SORTNUM を 8 と指定した場合は、合計で 24 個のソート作業データ・セットがジョブに割り振られます。

各ソート作業データ・セットは、16 MB 境界より上と下の両方の仮想ストレージを使用します。そのため、SORTNUM に指定する値が高すぎると、仮想ストレージ制約のためにユーティリティーの並列処理の度合いが減る可能性があります。 並列処理の度合いは最大で 1 まで減る可能性があり、それは並列処理を使用しないことを意味します。

重要: サブシステム・パラメーター UTSORTAL が YES に設定され、かつ IGNSORTN が YES に設定されている場合は、CHECK INDEX は SORTNUM キーワードを無視します。
変更の始まりPARALLEL num-subtasks変更の終わり
変更の始まり索引の一貫性を検査するサブタスクを並行して開始する際の最大数を指定します。

num-subtasks の値は 0 以上 32767 以下の整数でなければなりません。 num-subtasks に指定された値が 32767 より大きい場合、CHECK INDEX ステートメントは失敗します。 num-subtasks に 0 が指定された場合、または値が指定されない場合、CHECK INDEX ユーティリティーは並列サブタスクの最適数を使用します。 num-subtasks に指定された値が、計算された最適数よりも大きい場合、CHECK INDEX ユーティリティーは、制約を適用して並列サブタスクの数を最適数に制限します。 通常、CHECK INDEX は、2 個または 3 個からなるグループとしてサブタスクを割り振ります。 そのため、開始されるサブタスクの実際の数は、PARALLEL オプションで指定した数より少なくなることがあります。

PARALLEL で指定するサブタスク数は、PARAMDEG_UTIL サブシステム・パラメーターの値を常にオーバーライドします。 したがって、PARALLEL は PARAMDEG_UTIL の値より小さくすることも大きくすることもできます。

変更の終わり