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

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

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

構文図

>>-CHECK--LOB--| lob-table-space-spec  |------------------------>

   .-SHRLEVEL--REFERENCE-.                   
>--+---------------------+--| drain-spec |---------------------->
   '-SHRLEVEL--CHANGE----'                   

   .-EXCEPTIONS--0-------.  .-PUNCHDDN--SYSPUNCH-.   
>--+---------------------+--+--------------------+-------------->
   '-EXCEPTIONS -integer-'  '-PUNCHDDN--ddname---'   

>--+-----------------------+--+------------------+-------------><
   '-SORTDEVT--device-type-'  '-SORTNUM--integer-'   

lob-table-space-spec:

>>-TABLESPACE--+----------------+--lob-table-space-name--------->
               '-database-name.-'                         

>--+-------+---------------------------------------------------><
   '-CLONE-'   

drain-spec:

構文図を読む
   .-DRAIN_WAIT--IRLMRWT value-.  .-RETRY--UTIMOUT value-.   
>>-+---------------------------+--+----------------------+------>
   '-DRAIN_WAIT--integer-------'  '-RETRY--integer-------'   

>--+----------------------+------------------------------------><
   '-RETRY_DELAY--integer-'   

オプションの説明

LOB
損傷がないか LOB 表スペースを検査することを指示します。
TABLESPACE database-name.lob-table-space-name
データが属している表スペースを指定します。

database-name は、データベースの名前であり、オプションです。

デフォルト値は、DSNDB04 です。

lob-table-space-name は、LOB 表スペースの名前です。

SHRLEVEL
検査される索引、表スペース、 またはパーティションに対して CHECK LOB 処理中に許可されるアクセスのタイプを指定します。
REFERENCE
CHECK INDEX 処理の際にチェックされる索引、表スペース、またはパーティションから読み取り可能で、 書き込みは不可能なアプリケーションを示します。
CHANGE
アプリケーションが、検査される索引、表スペース、またはパーティションの読み取りと 書き込みをできるということを指定します。

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

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

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

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

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

RETRY integer
CHECK LOB が試行する再試行の最大数を指定します。

integer は 0 から 255 まで任意の整数です。 RETRY が指定されていない場合、CHECK LOB は、ユーティリティー乗数 システム・パラメーター UTIMOUT の値を使用します。

RETRY が指定されていると、処理コストが増加し、 指定された索引、表スペース、またはパーティションが読み取り専用アクセスになる期間が、 長引いたり複数期間になってしまう恐れがあります。

RETRY_DELAY integer
再試行と再試行の間の最小所要時間を秒数で指定し ます。integer は 1 から 1800 まで任意の整数です。

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

  • DRAIN_WAIT 値 × RETRY 値
  • DRAIN_WAIT 値 × 10
EXCEPTIONS integer
メッセージによってのみ報告される、例外の最大数を指定します。 CHECK LOB は、指定された例外数に達すると、CHECKLOB フェーズで終了します。

メッセージによって報告された損傷はすべて、例外としてカウントされます。

integer は、例外の最大数です。

デフォルト値は 0 です。 これは、例外数が無制限であることを意味します。

PUNCHDDN ddname
CHECK LOB SHRLEVEL CHANGE が生成する REPAIR ユーティリティー制御ステートメントを 受け入れるデータ・セットの DD ステートメントを指定します。生成された REPAIR ステートメントは、 エラー・メッセージに報告された LOB を LOB 表スペースから 削除します。その後、基本表スペースに対して CHECK DATA を実行して、 基底レコード内の削除 LOB 列を無効に設定する必要があります。

ddname は DD 名です。

デフォルト値は、SYSPUNCH です。

PUNCHDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。

SORTDEVT device-type
ソート・プログラムによって動的に割り振られる一時データ・セットの装置タイプを 指定します。

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

device-type は装置タイプです。ソート・プログラムの SORT または OPTION 制御ステートメントの DYNALLOC パラメーターで受け入れられるものであれば、任意のディスク装置タイプを指定できます。変更の始まり 磁気テープ装置は、ソート・プログラムではサポートされません。変更の終わり

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

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

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

SORTDEVT を省略した場合、SORTNUM は無視され ます。SORTDEVT を使用し、SORTNUM を省略した場合、 ソート・プログラムへは値は 渡されず、DFSORT はそれ自身のデフォルトを使用します。各ソートごとに最低 2 つのソート用作業データ・セットが必要です。

重要: SORTNUM キーワードは、UTSORTAL サブシステム・パラメーターが YES に設定されており、かつ IGNSORTN サブシステム・パラメーターが YES に設定されている場合は無視されます。
CLONE
CHECK LOB が、基本表の LOB データはチェックせず、 クローン表のみの LOB スペース・データを検査することを指示します。