REORG INDEX 制御ステートメントの構文とオプション
REORG INDEX ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。
制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。
構文図
>>-REORG--+-INDEX--LIST--listdef-name-+--+-------+--+-------+---> '-| index-name-spec |-------' '-REUSE-' '-CLONE-' .-SHRLEVEL NONE------------------------------------------------------------------------------. >--+--------------------------------------------------------------------------------------------+--> | .-FASTSWITCH YES-. | '-SHRLEVEL-+-REFERENCE--| deadline-spec |--| drain-spec |---------------+-+----------------+-' '-CHANGE--| deadline-spec |--| drain-spec |--| change-spec |-' '-FASTSWITCH NO--' .-FORCE--NONE----. >--+----------------+-------------------------------------------> +-FORCE--READERS-+ '-FORCE--ALL-----' >--+------------------------------------------+-----------------> '-LEAFDISTLIMIT-+---------+-+------------+-' '-integer-' '-REPORTONLY-' .-UNLOAD--CONTINUE------. >--+-----------------------+--+--------------------+------------> | (1) | | (2) | '-UNLOAD--+-PAUSE-----+-' '-| stats-spec |-----' '-ONLY------' >--+-----------------------+--+------------------+--------------> '-SORTDEVT--device-type-' '-SORTNUM--integer-' .-WORKDDN--(SYSUT1)-. >--+-------------------+--+-----------+-------------------------> '-WORKDDN--(ddname)-' '-PREFORMAT-' .-FLASHCOPY--NO-------------------------------------------------. >--+---------------------------------------------------------------+--> '-FLASHCOPY--+-YES--------+--+--------------------------------+-' '-CONSISTENT-' '-FCCOPYDDN--(--template-name--)-' >--+----------------------------------+------------------------>< '-RBALRSN_CONVERSION--+-NONE-----+-' +-BASIC----+ '-EXTENDED-'
- UNLOAD PAUSE は LIST オプションとは併用できません。
- UNLOAD ONLY オプションの stats-spec では、オプションは何も指定できません。
index-name-spec >>-+-INDEX-+-------------+-index-name---------------+-----------> | '-creator-id.-' | '-INDEXSPACE-+----------------+-index-space-name-' '-database-name.-' >--+---------------+------------------------------------------->< '-PART--integer-'
deadline-spec .-DEADLINE--NONE--------------------------------. >>-+-----------------------------------------------+----------->< '-DEADLINE--+-timestamp-----------------------+-' '-| labeled-duration-expression |-'
drain-spec (1) (2) >>-+---------------------+------+----------------+--------------> '-DRAIN_WAIT--integer-' '-RETRY--integer-' (3) .-TIMEOUT--TERM--. >--+----------------------+------+----------------+------------>< '-RETRY_DELAY--integer-' '-TIMEOUT--ABEND-'
- DRAIN_WAIT のデフォルトは、IRLMRWT サブシステム・パラメーターの値です。
- RETRY のデフォルトは、UTIMOUT サブシステム・パラメーターの値です。
- RETRY_DELAY の デフォルトは、DRAIN_WAIT 値 × RETRY 値と、DRAIN_WAIT 値 × 10 の 2 つの値のうち小さい方の値です。
change-spec .-DRAIN--ALL-----. >>-+------------------------+--+----------------+---------------> | (1) | '-DRAIN--WRITERS-' '-MAXRO--+-integer-+-----' '-DEFER---' .-LONGLOG--CONTINUE--. .-DELAY--1200----. >--+--------------------+--+----------------+-------------------> '-LONGLOG--+-TERM--+-' '-DELAY--integer-' '-DRAIN-' .-LOGRANGES--YES-. >--+----------------+-------------------------------------------> '-LOGRANGES--NO--' .-SWITCHTIME--NONE---------------------------------------------------. >--+--------------------------------------------------------------------+->< | .-NEWMAXRO--NONE----. | '-SWITCHTIME--+-timestamp-------------------+--+-------------------+-' '-labeled-duration-expression-' '-NEWMAXRO--integer-'
- MAXRO のデフォルトは、RETRY_DELAY デフォルト値です。
labeled-duration-expression >>-+-CURRENT_DATE--------------------------+--------------------> '-CURRENT_TIMESTAMP--+----------------+-' '-WITH TIME ZONE-' .------------------------------------------. V | >----+- + -+--定数 (constant)--+-YEAR---------+-+---------------->< '- - -' +-YEARS--------+ +-MONTH--------+ +-MONTHS-------+ +-DAY----------+ +-DAYS---------+ +-HOUR---------+ +-HOURS--------+ +-MINUTE-------+ +-MINUTES------+ +-SECOND-------+ +-SECONDS------+ +-MICROSECOND--+ '-MICROSECONDS-'
stats-spec:
.-REPORT--NO--. >>-STATISTICS--+-------------+--correlation-stats-spec----------> '-REPORT--YES-' .-UPDATE--ALL------------. >--+------------------------+--+-------------------------+------> '-UPDATE--+-ACCESSPATH-+-' '-HISTORY--+-ALL--------+-' +-SPACE ---+ +-ACCESSPATH-+ '-NONE-------' +-SPACE ---+ '-NONE-------' >--+----------------------+------------------------------------>< '-FORCEROLLUP--+-YES-+-' '-NO--'
correlation-stats-spec:
(1) .-KEYCARD-----. >>-+-------------+----------------------------------------------> .-FREQVAL--NUMCOLS--1--COUNT--10--------------------. >--+---------------------------------------------------+--------> | .-----------------------------------------------. | | V .-COUNT--10------. | | '---FREQVAL--NUMCOLS--integer--+----------------+-+-' '-COUNT -integer-' .-NUMCOLS--1--NUMQUANTILES--100---------------. >--HISTOGRAM--+---------------------------------------------+-->< | .-NUMQUANTILES--100-----. | '-NUMCOLS--integer--+-----------------------+-' '-NUMQUANTILES--integer-'
- KEYCARD オプションは推奨されません。以前、KEYCARD により制御されていたこの機能は、REBUILD INDEX STATISTICS の実行時におけるインライン統計のデフォルト処理に組み込まれたため、無効にすることはできません。
オプションの説明
- INDEX creator-id.index-name
- 再編成する索引を指定します。
creator-id. オプションで、索引の作成者を指定します。修飾子の作成者 ID が省略されている 場合、Db2® はユーティリティー・ジョブの ユーザー ID を使用します。index-name は、コピーする索引の修飾名です。索引については、索引名でも索引スペース名でも指定することができます。 名前にブランクが含まれている場合は、索引名を引用符で囲みます。
- INDEXSPACE database-name.index-space-name
- SYSIBM.SYSINDEXES 表から得られる、索引スペースの修飾名を指定します。
database-name は、索引に関連したデータベースの名前を指定します。これは、オプションです。
デフォルト値は、DSNDB04 です。
index-space-name 再編成する索引スペースの修飾名を指定します。 この名前は、SYSIBM.SYSINDEXES 表から得られます。
- LIST listdef-name
- 前に定義された LISTDEF リスト名の名前を指定し
ます。この REORG INDEX LIST を REORG TABLESPACE LIST と区別するため、INDEX キーワードは必須です。
このユーティリティーでは、REORG INDEX のそれぞれの制御ステートメントごとに、LIST キーワード
を 1 つ使用することができます。リストには、表スペースは入れないでくだ
さい。リスト中の各項目ごとに 1 回 REORG INDEX が
起動されます。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。
LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。
STATISTICS INDEX index-name は REORG INDEX LIST と一緒には指定しないでください。 索引のリストについて、インライン統計を収集する場合は、STATISTICS のみを指定してください。
いずれのユーティリティーでも、DSNUM および PART は LIST と一緒には指定できません。
パーティションまたは パーティション範囲をリストに指定できます。
- PART integer
再編成するパーティションを示します。パーティションを分けている索引の単一のパーティションを再編成することが
できます。PART は LIST と一緒には指定できま
せん。
integer は物理パーティション番号です。1 から、パーティション索引に定義されたパーティション数までの範囲でなければなりません。
最大値は 4096 です。integer は、単一のパーティションを指定します。
PART キーワードを省略すると、索引全体が再編成されます。

- REUSE
- SHRLEVEL NONE と共に使用された場合、REORG は DB2 管理対象データ・セットを削除して再定義せずに、論理的にリセットし、
再使用することを指定します。
REUSE および SHRLEVEL NONE が指定されていない場合、Db2 は Db2 管理対象データ・セットを
削除してから再定義することで、それらをリセットします。
データ・セットに複数のエクステントがある場合に REUSE パラメーターを使用すると、 そのエクステントは解放されません。
SHRLEVEL REFERENCE または CHANGE を REUSE と一緒指定した場合、REUSE は適用されません。
- CLONE
- クローン表に定義された、指定された索引スペースおよび索引のみを、REORG INDEX が再編成することを 指示します。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。 LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。
- SHRLEVEL
- 再編成を実行する方法を指定し
ます。SHRLEVEL に続くパラメーターは、REORG の RELOAD フェーズ中に許されるアクセスのタイプを示します。
- NONE
- 再編成されるエリアからのアンロード (その間、アプリケーションは読み取り
はできるが、エリアへの書き込みはできない)、そのエリアへの作成 (その間、
アプリケーションは何もアクセスできない)、およびその後に、再び読み取り/書き込みアクセス
を可能にすることによって、再編成を行うことを指定します。
NONE を (明示的にまたはデフォルトで) 指定した場合は、以下のパラメーターは指定できません。
- MAXRO
- LONGLOG
- DELAY
- DEADLINE
- DRAIN_WAIT
- RETRY
- RETRY_DELAY
- REFERENCE
- 再編成を以下のように行うことを指定します。
- 再編成されるエリアからアンロードします。 その間、アプリケーションは読み取ることはできますが、 そのエリアに書き込むことはできません。
- そのエリアのシャドー・コピーの中に作成します。その間、アプリケーションは読み取ることは できますが、オリジナル・コピーには書き込むことはできません。
- データ・セット名を入れ替えて、その後、再び読み取り/書き込みを可能にすることによって、 アプリケーションのその後のアクセスをオリジナル・コピーからシャドー・コピーへ切り替えます。
REFERENCE を指定する場合は、以下のパラメーターを指定することはできません。
- UNLOAD (REFERENCE を用いた再編成では、常に UNLOAD CONTINUE を実行します。)
- MAXRO
- LONGLOG
- DELAY
- CHANGE
- 再編成を以下のように行うことを指定します。
- 再編成されるエリアからアンロードします。その間、アプリケーションは読み取りと そのエリアへの書き込みが可能です。
- そのエリアのシャドー・コピーの中に作成します。その間、アプリケーションは読み取りと オリジナル・コピーへの書き込みができます。
- オリジナル・コピーのログをシャドー・コピーに適用します。その間、アプリケーションは 読み取ることができ、通常はオリジナル・コピーへ書き込むことができます。
- データ・セット名を入れ替えて、その後、再び読み取り/書き込みを可能にすることによって、 アプリケーションのその後のアクセスをオリジナル・コピーからシャドー・コピーへ切り替えます。
CHANGE を指定すると、UNLOAD パラメーターは指定できま せん。CHANGE を用いた再編成では、常に UNLOAD CONTINUE を実行します。
表スペースが NOT LOGGED 属性を持っている場合、SHRLEVEL CHANGE を 指定することはできません。
- DEADLINE
- SWITCH フェーズ開始の期限を指定します。Db2 が SWITCH フェーズは期限までには開始しないと
推定すると、Db2 は、DISPLAY UTILITY コマンド
が出すメッセージを出してから、再編成を終了させます。
DEADLINE の最終結果とすべてのタイム・スタンプ計算が TIMESTAMP(6) に含められます。
- NONE
- ログ処理の SWITCH フェーズには開始期限はないことを指定します。
- timestamp
- ログ処理の SWITCH フェーズの開始期限を指定します。 この期限は、REORG を実行したときに、既に過ぎていてはなりません。
- labeled-duration-expression
- ログ処理での SWITCH フェーズが開始する期限を計算します。
計算は、CURRENT TIMESTAMP もしくは CURRENT DATE に基づいて行われます。
1 つ以上の定数の値を加えるか、引いて、期限を指定することができます。
この期限は、REORG を実行したときに、既に過ぎていてはなりません。
CURRENT TIMESTAMP と CURRENT DATE は、REORG ステートメントが最初に処理されるときに一度評価されます。オブジェクトのリストが指定された場合は、リスト内のすべてのオブジェクトについて、同じ値が有効になります。
- CURRENT_DATE
- CURRENT DATE を基にして期限を計算することを指定します。
- CURRENT_TIMESTAMP
- CURRENT TIMESTAMP を基にして期限を計算することを指定します。
- WITH TIME ZONE
- CURRENT TIMESTAMP を時間帯列と比較することを指定します。特殊レジスター CURRENT TIMESTAMP のタイム・スタンプ精度は、列のタイム・スタンプ精度と同じである必要があります。同じでない場合は、デフォルトのタイム・スタンプ精度が使用されます。CURRENT TIMESTAMP の時間帯は、特殊レジスター CURRENT TIMEZONE の値です。比較は、タイム・スタンプの UTC 部分を比較することによって行われます。
- 定数 (constant)
- 時間の単位を示し、その後に、7 つの期間キーワードの YEARS、 MONTHS、DAYS、HOURS、MINUTES、SECONDS、または MICROSECONDS のいずれかが続きます。 これらのワードは、YEAR、 MONTH、DAY、HOUR、MINUTE、SECOND、MICROSECOND のように、単数形も受け入れ可能です。
REORG SHRLEVEL REFERENCE または SHRLEVEL CHANGE が DEADLINE 指定が原因で終了した場合、Db2 は 理由コード 2 を伴ってメッセージ DSNU374I を発行しますが、限定状況は設定しません。
- DRAIN_WAIT integer
- ユーティリティーが、SQL ステートメント (挿入、更新、削除、および選択) をドレーンする際の 待ち時間を秒数で指定します。 指定する時間は、再編成する索引のすべてのパーティションについて集約した時間です。 このような SQL ステートメントの場合のみ、この値は、IRLMRWT および UTIMOUT で指定された 値をオーバーライドします。コマンドのような操作の場合は、IRLMRWT および UTIMOUT の 値が使用されます。integer の有効な値は、0 から 1800 までです。このキーワードが省略されているか、値 0 が指定 されている場合、このユーティリティーは、ロック・タイムアウト・システム・パラメーター IRLMRWT の値を使用します。
- RETRY integer
- REORG が試行すべき再試行の最大数を指定します。
integer の有効な値は、0 から 255 までです。
RETRY を指定すると、処理コストの増大につながる可能性があり、結果として、読み取り専用アクセス の期間が倍になったり、延びる恐れがあります。
デフォルト値は、UTIMOUT サブシステム・パラメーターの値です。
- RETRY_DELAY integer
- 再試行と再試行の間の最小所要時間を秒数で指定し
ます。integer の有効な値は、1 から 1800 までです。RETRY_DELAY が 指定されていない場合、REORG INDEX は以下の 2 つの値の小さい方を使用します。
- DRAIN_WAIT 値 × RETRY 値
- DRAIN_WAIT 値 × 10
- MAXRO integer
- ログ処理の最後の反復のための最大時間を指定します。
その反復時には、
アプリケーションには読取専用アクセスが割り当てられます。
最後の反復の実際の実行時間は、MAXRO で指定された値を超える場合があります。
ALTER UTILITY コマンドが MAXRO の値を変更できます。
デフォルト値 は RETRY_DELAY デフォルト値です。
- 整数
- integer は秒数です。
小さな正の値を指定すると、読み取り専用アクセス時間の長さは短縮されますが、REORG が
完了するまでの経過時間が増加することになります。
非常に大きな正の値を指定すると、ログ処理の 2 回目の反復が、おそらく、
最後の反復になります。
デフォルト値は 300 秒です。
- DEFER
- 読み取り/書き込みアクセスに伴うログ処理の反復が無限に続くことを指定し
ます。ALTER UTILITY コマンドを使用して MAXRO 値を変更しない限り、REORG は読み取り専用アクセスを伴う最後
の反復を開始することはありません。
DEFER を指定する場合は、LONGLOG CONTINUE も指定してください。
DEFER が指定されていて、Db2 が、1 回の反復の実際の時間と次回の反復の見積時間が両方とも 5 秒より短いと 判断した場合は、Db2 は、次回の反復に 5 秒間の 休止を追加します。 この休止により、プロセッサー時間の使用量が削減されます。 ある特定の REORG の実行でこの状態が初めて発生したとき、Db2 は メッセージ DSNU362I をコンソールに送信します。このメッセージは、処理が必要なログ・レコード数が少なく、 休止が発生することを通知するものです。MAXRO 値を変更して、その結果 REORG を終了させるには、ALTER UTILITY コマンドを実行してください。Db2 はその状態が発生すればいつでも休止を追加します。しかし、Db2 は、特定の REORG の実行に関する最後のメッセージが送られてから 30 分経過してはじめて、このメッセージを送ります。
- DRAIN
- MAXRO のしきい値に達した後の LOG フェーズの終わりでのドレーンの
動作、およびログの最後の反復をいつ適用するかを指定します。
- WRITERS
- LOG フェーズ中に MAXRO しきい値に達すると、Db2 が書き込みプログラムのみをドレーンし、次いで SWITCH フェーズに入るときに DRAIN ALL を出すことを指定します。
ALL
- 現行デフォルト・アクションを指定します。このアクションでは、
Db2 は LOG フェーズ中に MAXRO のしきい値に達した後、読み取りプログラムと書き込みプログラムをすべてドレーンします。
以下の条件が両方とも当てはまる場合は、DRAIN ALL の指定を考慮してください。
- LOG フェーズでは SQL 更新アクティビティーが頻繁に行われる。
- デフォルトの動作の結果、多数の -911 SQL エラー・メッセージが出される。
- LONGLOG
- ログ処理の次回の反復が処理するレコード数が、前回の反復が処理した数より
十分に少なくなっていない場合に、Db2 が
コンソールにメッセージを送信した後に実行するアクションを指定します。このような状況は、REORG INDEX が
アプリケーション・ログを読み取る速さが不十分で、アプリケーション・ログの書き込みのペースに合わせられない
ことを意味しています。
- CONTINUE
- 1 回の反復の実行時間の見積もりが MAXRO で指定された時間を超えた場合に、Db2 が
再編成 (ログ処理の反復を含む) の実行を JOB ステートメント上の時間が切れるまで継続することを指定します。
MAXRO の DEFER 値および LONGLOG の CONTINUE 値がともに意味しているのは、REORG INDEX は、 再編成されるエリアのオリジナル・コピーへのアクセスを引き続き認めており、シャドー・コピーには 切り換えないということです。 ユーザーは、切り替えが必要であれば、MAXRO に大きな値を用いて ALTER UTILITY コマンドを 実行することができます。
- TERM
- DELAY パラメーターによって指定された遅延の後に Db2 が 再編成を終了することを指定します。
- DRAIN
- DELAY パラメーターで指定された遅延の後に Db2 が 書き込みクレーム・クラスをドレーンすることを指定します。このアクションにより、ログ処理の最後の反復の実行が強制されます。
- DELAY integer
- REORG が LONGLOG メッセージをコンソールに送る時刻と、REORG が LONGLOG パラメーター
で指定されたアクションを実行する時刻との間の最小時間間隔を指定します。
integer は秒数です。
デフォルト値は 1200 です。
- TIMEOUT
- REORG INDEX ユーティリティーが、LOG フェーズもしくは SWITCH フェーズで、
オブジェクトをドレーンしようとしてタイムアウト条件となった場合に、とるべきアクションを指定します。
- TERM
- TERM オプションが指定されている場合にタイムアウト条件が起こると Db2 が
次のように動作することを指示します。
- Db2 は、暗黙の TERM UTILITY コマンドを発行します。これによって、ユーティリティーは 戻りコード 8 で終了します。
- Db2 は メッセージ DSNU590I および DSNU170I を発行します。
- Db2 はオブジェクトを RW 状態の ままにします。
- ABEND
- タイムアウト条件が生じた場合、Db2 はオブジェクトを UTRO または UTUT 状態のままに しておくことを示しています。
LOGRANGES
REORG が LOG フェーズ用に SYSLGRNX 情報を使用するかどうかを指定します。- YES
- REORG は、LOG フェーズ用に可能な限り SYSLGRNX 情報を使用します。 このオプションがデフォルトの動作です。
- NO
- REORG は LOG フェーズ用に SYSLGRNX 情報を使用しません。 このオプションを使用すると、REORG の実行時間がかなり長くなります。 データ共用環境では、このオプションによって、すべてのメンバーからのすべてのログがマージされることになる場合があります。 このオプションは、SYSLGRNX 項目に関する既知の保全性問題、およびログ読み取り決定のために SYSLGRNX にアクセスする際のパフォーマンス上の問題がある場合に適切です。

SWITCHTIME
LOG フェーズの最終ログ反復が開始する時刻を指定します。
SWITCHTIME の最終結果とすべてのタイム・スタンプ計算が TIMESTAMP(6) に含められます。
このキーワードは、MAXRO キーワードと共に指定できます。MAXRO DEFER が指定されていないと、指定された (もしくはデフォルトの) MAXRO 基準が満たされている場合に、REORG は指定された SWITCHTIME 値の前に LOG フェーズの最後のログの反復に入ることができます。
MAXRO DEFER が指定されていると、指定された SWITCHTIME が満たされるまで、あるいは MAXRO 値の変更時の外部 ALTER UTILITY コマンドの影響を受けるまで、REORG は最後のログの反復に入ることを試みません。- NONE
- LOG フェーズの最後のログの反復に関する時刻を指定しません。このオプションがデフォルトの動作です。
- timestamp
- LOG フェーズの最終ログ反復が開始する時刻を指定します。 この時刻は、REORG の実行時にはまだ到達していない時刻でなければなりません。
- labeled-duration-expression
- LOG フェーズの最後のログの反復が開始される時刻を計算します。計算は、CURRENT TIMESTAMP もしくは CURRENT DATE に基づいて行われます。
1 つ以上の定数の値を加えるか、引いて、切り替え時刻を指定することができます。この切り替え時刻は、REORG の実行時にはまだ到達していない時刻でなければなりません。CURRENT TIMESTAMP および CURRENT DATE は、REORG ステートメントが初めて処理される時に、一度だけ評価されます。オブジェクトのリストが指定された場合は、リスト内のすべてのオブジェクトについて、同じ値が有効になります。
- CURRENT_DATE
- CURRENT DATE を基にして期限を計算することを指定します。
- CURRENT_TIMESTAMP
- CURRENT TIMESTAMP を基にして期限を計算することを指定します。
- WITH TIME ZONE
- CURRENT TIMESTAMP を時間帯列と比較することを指定します。特殊レジスター CURRENT TIMESTAMP のタイム・スタンプ精度は、列のタイム・スタンプ精度と同じである必要があります。同じでない場合は、デフォルトのタイム・スタンプ精度が使用されます。CURRENT TIMESTAMP の時間帯は、特殊レジスター CURRENT TIMEZONE の値です。比較は、タイム・スタンプの協定世界時の部分を比較することによって行われます。
- 定数 (constant)
- 時間の単位を示し、その後に、7 つの期間キーワードの YEARS、 MONTHS、DAYS、HOURS、MINUTES、SECONDS、または MICROSECONDS のいずれかが続きます。 これらのワードは、YEAR、 MONTH、DAY、HOUR、MINUTE、SECOND、MICROSECOND のように、単数形も受け入れ可能です。

NEWMAXRO
SWITCHTIME に達した後の、最終ログ反復の最大時間を指定します。
SWITCHTIME キーワードも指定しなければなりません。この値は、指定されている既存の MAXRO パラメーターをオーバーライドします。デフォルトは、NONE です。- NONE
- 指定の SWITCHTIME に達したとき、ログの処理時間を考慮に含めないで、REORG が最終ログ反復に進むように指定します。 NONE を指定すると、REORG は、指定された SWITCHTIME とほぼ同時かその直後に最後のログの反復に入ります。このオプションがデフォルトです。
- 整数
- integer は秒数です。 小さな正の値を指定すると、読み取り専用アクセス時間の長さは短縮されますが、REORG が 完了するまでの経過時間が増加することになります。 大きな正の値を指定すると、REORG が、ほぼ即時にまたは指定の SWITCHTIME 以降に最終ログ反復に入る可能性が大きくなります。

- FORCE
- ユーティリティーが表スペースをドレーンしているときにとるべきアクションを指定します。
REORG FORCE がスレッドをキャンセルするときは、CANCEL THREAD で実行 される場合同様のソフト・キャンセルが実行されます。
- NONE
- REORG によるドレーンの実行時に、アクションを実行しないことを指定します。REORG ユーティリティーは、クレーマーがコミットするのを待機します。ドレーンが失敗すると、既存の条件による指定に従い、ユーティリティーはタイムアウトになるか再始動します。
- READERS
- 最後の RETRY 処理で、REORG により DRAIN ALL が要求される場合に、読み取りクレーマーをキャンセルすることを指定します。
- ALL
- 最後の RETRY 処理で REORG が DRAIN ALL または DRAIN WRITERS を要求する際に、読み取りクレーマーと書き込みクレーマーの両方をキャンセルすることを指定します。
- FASTSWITCH
- 再編成に使用する切り替え方法を指定します。
FASTSWITCH を SHRLEVEL CHANGE または SHRLEVEL REFERENCE と共に指定すると、NONE、BASIC、または EXTENDED を設定した UTILITY_OBJECT_CONVERSION サブシステム・パラメーターが受け入れられます。
- YES
- SWITCH フェーズで FASTSWITCH 方法論を使用できるようにします。このオプションは、カタログ (DSNDB06) またはディレクトリー (DSNDB01) では使用できません。
- NO
- SWITCH フェーズで IDCAMS RENAME が使用されます。
- LEAFDISTLIMIT integer
integer の値を、SYSIBM.SYSINDEXPART で指定された索引の、指定されたパーティションの LEAFDIST の値と比較することを指定し ます。LEAFDIST の値が指定された LEAFDISTLIMIT の値を超えている場合は、REORG を実行します。 あるいは、REPORTONLY が指定されている場合はその実行を推奨します。
LEAFDISTLIMIT オプションは推奨されないため、代わりの方法として DSNACCOX を実行します。
デフォルト値は 200 です。
LEAFDISTLIMIT が指定されている場合、ノード ID 索引、補助索引、ハッシュ索引、または XML 索引で LEAFDIST 値が -2 であるために、これらの索引に対して REORG は実行されません。
- REPORTONLY
REORG は推奨するだけで、実行はしないことを指定します。REORG は、以下のいずれかの 戻りコードを伴った報告書を作成します。
REPORTONLY オプションは推奨されないため、代わりの方法として DSNACCOX を実行します。
- 1
- 限界に達しません。REORG は実行されず、推奨もされません。
- 2
- REORG は、実行または推奨されます。
- UNLOAD
- データがアンロードされた後、ユーティリティー・ジョブが処理を継続すべきか、
終了すべきかを指定します。
- CONTINUE
- データがアンロードされた後、ユーティリティーが処理を継続することを指定します。
- PAUSE
データがアンロードされた後、処理は終了することを指定します。 ユーティリティーは停止し、RELOAD 状況は SYSIBM.SYSUTIL に保管される ため、RELOAD RESTART(PHASE) によって処理を再始動することができます。
UNLOAD PAUSE オプションは推奨されません。キーのアンロード後にユーティリティーを停止する必要がある場合は、DIAGNOSE と REORG ユーティリティーを組み合わせて使用し、プロセスを停止 (休止) します。
このオプションは、再編成中にデータ・セットを再定義する場合に便利です。 例えば、ユーザー定義のデータ・セットでは、以下のことが行えます。
- UNLOAD PAUSE オプションを用いて REORG を実行する。
- アクセス方式サービスを使用してデータ・セットを再定義する。
- 前のジョブを再サブミットし、RESTART(PHASE) を指定して、REORG を再始動する。
UNLOAD PAUSE の際にアンロードされるレコードがない場合は、REORG の再始動時 に、RELOAD および BUILD フェーズはバイパスされます。
LIST オプションを指定した場合には、UNLOAD PAUSE は使用できません。
- ONLY
データがアンロードされた後に、ユーティリティー・ジョブを終了させ、 このユーティリティーの ID に対応する SYSIBM.SYSUTIL の状況を除去することを指定します。
UNLOAD ONLY オプションは推奨されません。キーをアンロードする必要がある場合は、DIAGNOSE と REORG ユーティリティーを組み合わせて使用し、キーのアンロード後にプロセスを停止し、TERM UTIL を実行してユーティリティーを終了します。
- STATISTICS
- 索引の統計を収集することを指定します。
統計は、報告されるか、または、Db2 カタログに保管されます。
カタログおよびディレクトリー表の索引についてのインライン統計を収集することはできません。
制約事項:
- 暗号化されたデータに対して STATISTICS が指定された場合、Db2 は、 このデータに関する有用な情報を提供しない可能性があります。
- STATISTICS をクローン・オブジェクトに対して指定することはできません。
REORG INDEX を SHRLEVEL REFERENCE または SHRLEVEL CHANGE 付きで使用している間にペンディングの定義変更がマテリアライズされた場合は、デフォルトでは Db2 カタログで索引統計が収集および更新されます。
ペンディングの定義変更のマテリアライズ時に SHRLEVEL REFERENCE または CHANGE ステートメントを使用した REORG INDEX で STATISTICS キーワードを指定しなかった場合は、デフォルトではキーワード STATISTICS UPDATE ALL HISTORY ALL が実行されます。ペンディングの定義変更のマテリアライズ時に SHRLEVEL REFERENCE または SHRLEVEL CHANGE ステートメントを使用した REORG INDEX で STATISTICS キーワードも指定すると、指定されたオプションによってデフォルト・オプションが上書きされます。
推奨事項: ペンディングの定義変更のマテリアライズが原因で、一部のパーティション統計が廃止になることがあります。廃止になる可能性があるパーティション統計は、COLGROUP 統計、索引のキー列値の統計、HISTOGRAM 統計、NUMCOLS > 1 の頻度統計、および拡張された索引の統計 (該当する場合) です。パーティション統計を再度収集するには、RUNSTATS ユーティリティーを実行します。
- REPORT
- 収集された統計を報告するメッセージ・セットを生成するかどうかを示します。
- NO
- メッセージのセットが出力として SYSPRINT に送られないことを示します。
- YES
- メッセージのセットが出力として SYSPRINT に送られることを示します。 生成されるメッセージは、RUNSTATS ユーティリティーで指定するキーワード (TABLESPACE、INDEX、TABLE、COLUMN など) の組み合わせによって異なります。 ただし、これらのメッセージは UPDATE オプションの指定に応じて変わることはありません。REPORT YES にすると、常に SPACE および ACCESSPATH 統計のレポートが生成されます。
- KEYCARD
- KEYCARD オプションは、ユーティリティー制御ステートメントで非推奨となり、索引のキー列内の値に関するカーディナリティー統計を収集する場合に指定する必要がなくなりました。
STATISTICS オプションが指定されると、このユーティリティーは自動的に、再作成される索引の 1 から n までのキー列のすべての組み合わせにある、異なるそれぞれの値をすべて収集します。n は索引内の列の数です。KEYCARD が非推奨になったことに伴い、 この機能を使用不可にすることはできなくなりました。
このユーティリティーでは、KEYCARD オプションを指定しても許容されます。STATISTICS が指定されると、このユーティリティーでは、制御ステートメントに KEYCARD オプションが含まれている場合も除外されている場合も、メッセージは発行されません。
- FREQVAL
- 頻度値統計の収集を制御します。
FREQVAL を指定する場合は、必ずその後に NUMCOLS キーワードを指定します。
- NUMCOLS
- 指定された索引から頻度値を収集する際に、連結するキー列の数を示し
ます。3 を指定すると、このユーティリティーは、最初の 3 つのキー列の連結についての
頻度値を収集します。
デフォルト値は 1 です。これは、Db2 が索引の先頭のキー列の頻度値のみを収集することを意味します。
- COUNT
- 収集する頻度の個数を指示します。
15 を指定すると、このユーティリティーは、指定されたキー列から 15 個の
頻度値を収集します。
デフォルト値は 10 です。
HISTOGRAM
指定された索引に関するヒストグラム統計が要求されることを示します。- NUMCOLS
- 指定された索引からヒストグラム統計を収集する際に連結するキー列の数。
- NUMQUANTILES
- NUMQUANTILES に続く整数値は、要求される変位値の数を示します。 この整数値は 1 以上でなければなりません。
ヒストグラム統計は、順序が同じキーについてのみ収集できます。ヒストグラム統計に関して指定されているキー列の順序が混合していたりランダムになったりしている場合、DSNU633I 警告メッセージが出されます。
REBUILD INDEX を使用して収集するヒストグラム統計は、RUNSTATS を使用して収集するヒストグラム統計と同じではありません。
REBUILD INDEX によって収集するヒストグラム統計は、単なる概算統計です。
より正確な統計を得るには、RUNSTATS を使用してください。

- UPDATE
- 収集された統計をカタログ表に挿入すべきかどうかを示します。
また、UPDATE によって、アクセス・パスの選択に使用される統計、またはデータベース管理者が使用する統計を選択することもできます。
- ALL
- すべての収集された統計をカタログ内で更新することを示します。
- ACCESSPATH
- アクセス・パスの選択に使用される統計を提供するカタログ表の列のみを更新することを示します。
- SPACE
- データベース管理者が特定の表スペースまたは索引の状況を評価するときに役立つ統計を 提供するカタログ表の列のみを更新することを示します。
- NONE
- 収集された統計によってカタログ表を更新しないことを示します。 このオプションは、REPORT YES が指定されている場合にのみ有効です。
- HISTORY
- カタログ表の挿入または更新をすべてカタログ履歴表に記録します。
デフォルトは、パネル DSNTIP6 の STATISTICS HISTORY で指定された値によって提供されます。
- ALL
- すべての収集された統計をカタログ履歴表内で更新することを示します。
- ACCESSPATH
- アクセス・パスの選択に使用される統計を提供するカタログ履歴表の列のみを更新することを示します。
- SPACE
- スペース関連のカタログ統計のみをカタログ履歴表内で更新することを示します。
- NONE
- 収集された統計によってカタログ履歴表を更新しないことを示します。
- FORCEROLLUP
- 一部の索引または索引パーティションが空であっても、
統計の集約またはロールアップを RUNSTATS の実行時に行うかどうかを示します。
このキーワードによって、オプティマイザーは最適なアクセス・パスを選択できます。
FORCEROLLUP キーワード で使用可能なオプションは次のとおりです。
- YES
- 一部の索引または索引パーティションにデータが存在しない場合であっても、 集約またはロールアップ処理を強制的に行うことを示します。
- NO
- すべての索引または索引パーティションにデータが存在する場合にのみ、集約またはロールアップを行うことを示します。
データが存在しない場合に、パネル DSNTIP6 の STATISTICS ROLLUP のインストール値が NO に 設定されていると、このユーティリティーは DSNU623I メッセージを発行します。
- SORTDEVT device-type
- 外部ソート・プログラムによって動的に割り振られる一時データ・セットの装置タイプを指定します。device-type には、ソート・プログラムの SORT または OPTION オプションの DYNALLOC パラメーターで有効ないずれかのディスク装置を指定してください。
磁気テープ装置は、ソート・プログラムではサポートされません。
- SORTNUM integer
- データに応じてパーティション化された副次索引の統計を収集する場合、動的に割り振られる
一時データ・セット数を指定します。SORTDEVT を省略した場合、SORTNUM は無視され
ます。SORTDEVT を使用し、SORTNUM を省略した場合、
ソート・プログラムへは値は
渡されません。ソート・プログラムでは、それ自体のデフォルトを使用します。
integer は一時データ・セット数で、可能な 範囲は 2 から 255 です。
REORG INDEX は索引キーをソートしません。実行される可能性のある 唯一のソートは、DPSI についてインライン統計が収集される場合です。
重要: SORTNUM キーワードは、UTSORTAL サブシステム・パラメーターが YES に設定されており、かつ IGNSORTN サブシステム・パラメーターが YES に設定されている場合は無視されます。 - WORKDDN(ddname)
- ddname はアンロード・データ・セットの DD ステートメントを指定します。
- DD 名 (ddname)
- 作成入力用の一時作業ファイルの DD 名です。
デフォルト値は SYSUT1 です。
WORKDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。
WORKDDN はオプション・キーワードであっても、JCL ではアンロード出力データ・セット用 の DD ステートメントが必要です。WORKDDN を指定しない場合、あるいは ddname なしで指定した 場合、JCL には SYSUT1 という名前の DD ステートメントが必要 です。ddname が与えられている場合は、DD 名に一致した DD ステートメントまたは TEMPLATE を 用意する必要があります。
- PREFORMAT
- 残りのページは、索引スペースの割り振り済み RBA の最高位置まで、
事前フォーマット設定されることを指定します。事前フォーマット設定は索引の作成後に行われます。
PREFORMAT は、索引スペース全体に対して、またはパーティション化索引スペースの 1 つのパーティションに 対して作動できます。
UNLOAD ONLY を指定すると、PREFORMAT は無視されます。
- FLASHCOPY
- オブジェクトのコピーを作成するために FlashCopy® テクノロジーを使用するかどうかを指定します。有効値は YES、NO、または CONSISTENT です。FlashCopy を使用すると、
パーティションごとまたはオブジェクトの部分ごとに、別のデータ・セットが
作成されます。
ユーティリティー制御ステートメントでの FlashCopy の指定により、Db2 サブシステム・パラメーターを使用して定義されている、FlashCopy に対するすべての指定がオーバーライドされます。このユーティリティーのデフォルトの動作として FlashCopy を使用することが FlashCopy サブシステム・パラメーターで指定されている場合は、ユーティリティー制御ステートメントで FLASHCOPY オプションを省略できます。
重要: 入力データ・セットが 1 シリンダー未満の場合は、FLASHCOPY 設定に関わらず、オブジェクトのコピーに FlashCopy テクノロジーが使用されないことがあります。FlashCopy が使用されない場合は、IDCAMS によってコピーが実行されます。- NO
- FlashCopy を作成しないことを指定します。FLASHCOPY では NO がデフォルト値です。
- YES
- オブジェクトをコピーするために FlashCopy テクノロジーを使用することを指定します。
YES は、Db2 データ・セット が FlashCopy バージョン 2 ディスク・ボリュームにある場合のみ指定してください。
重要: 以下の場合、REORG INDEX ユーティリティーでは、YES が指定されていても FlashCopy を使用しないことがあります。- FlashCopy バージョン 2 ディスク・ボリュームを使用できない
- ソース・トラックが既に FlashCopy 操作のターゲットになっている
- ターゲット・トラックが FlashCopy 操作のソースである
- コピーに関連する関係の最大数を超過した
FlashCopy イメージ・コピーはユーティリティー実行の SWITCH フェーズで作成されるため、コピー操作で従来の入出力方式の使用が強制される場合に SHRLEVEL REFERENCE または SHRLEVEL CHANGE を指定すると、さらに長時間の停止が発生するおそれがあります。
- CONSISTENT
- オブジェクトをコピーするために FlashCopy テクノロジーを使用することを指定します。REORG INDEX ユーティリティーによって作成される コピーは、既に整合しているため、ユーティリティーでは、CONSISTENT の指定を YES の 指定と同様に扱います。
RBALRSN_CONVERSION
REORG ユーティリティーの完了後に、ターゲット・オブジェクトの RBA または LRSN 形式を指定します。
このキーワードを指定しないと、UTILITY_OBJECT_CONVERSION サブシステム・パラメーターで指定された変換が受け入れられます。- NONE
- 変換が実行されないことを指定します。
基本の 6 バイト形式の表スペースに対して RBALRSN_CONVERSION NONE が指定されており、UTILITY_OBJECT_CONVERSION サブシステム・パラメーターが NOBASIC に設定されている場合、ユーティリティーは失敗します。
- BASIC
- 拡張 10 バイト形式のオブジェクトが検出された場合、6 バイトの基本形式に変換されることを指定します。
RBALRSN_CONVERSION BASIC が指定されており、UTILITY_OBJECT_CONVERSION サブシステム・パラメーターが NOBASIC に設定されている場合、ユーティリティーは失敗します。
- EXTENDED
- 基本の 6 バイト形式のオブジェクトが検出された場合、10 バイトの拡張形式に変換されることを指定します。
RBALRSN_CONVERSION を指定しない場合にサブシステム・パラメーター UTILITY_OBJECT_CONVERSION を BASIC または EXTENDED に設定すると、RBALRSN_CONVERSION のデフォルトは UTILITY_OBJECT_CONVERSION 値になります。
RBALRSN_CONVERSION を指定しない場合にサブシステム・パラメーター UTILITY_OBJECT_CONVERSION を NOBASIC に設定すると、RBALRSN_CONVERSION のデフォルトは EXTENDED になります。
CLONE 関係が存在する場合、ページ・セット変換は実行できません。 クローン関係の場合、クローン表をドロップし、基本表を拡張 10 バイト形式に変換してから、クローン表を再作成しなければなりません。

- FCCOPYDDN
- FlashCopy イメージ・コピーのデータ・セット名の作成に使用するテンプレートを指定します。FlashCopy の使用時に REORG INDEX 制御ステートメントの FCCOPYDDN に値を指定しなかった場合、使用するテンプレートは、FCCOPYDDN サブシステム・パラメーターに指定した値によって決定されます。
- (template-name)
- FlashCopy イメージ・コピーのデータ・セット名は、テンプレート指定に従って割り振られます。表スペース・レベルまたは索引スペース・レベルの FlashCopy イメージ・コピーの場合、パーティションまたは部分ごとにデータ・セットが割り振られるため、テンプレート指定でのデータ・セット命名規則が十分な程度に固有であることを確認してください。 &DSNUM 変数を使用してください。この変数は実行時にパーティション番号または部分番号に解決されます。
