DSN1COMP 制御ステートメントの構文とオプション
DSN1COMP ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。
DSN1COMP 構文図
表スペースの場合:
>>-DSN1COMP--+-------------------------+------------------------> +-32K---------------------+ '-PAGESIZE--(--+-4K--+--)-' +-8K--+ +-16K-+ '-32K-' >--+--------------------------+--+-------------------+----------> +-DSSIZE--(--integer--G--)-+ '-NUMPARTS(integer)-' '-LARGE--------------------' >--+-------------------+--+------------------+--+----------+----> '-FREEPAGE(integer)-' '-PCTFREE(integer)-' '-FULLCOPY-' >--+-------+--+-------------------+--+------------------+-------> '-REORG-' '-ROWLIMIT(integer)-' '-MAXROWS(integer)-' >--+---------------------------+------------------------------->< '-EXTNDICT(dictionary-name)-'
索引の場合:
>>-DSN1COMP--+------------------+------------------------------>< '-LEAFLIM(integer)-'
オプションの説明
DSN1COMP を実行する場合、EXEC ステートメントで以下のパラメーター を 1 つ以上指定します。 複数のパラメーターを指定する場合は、それぞれのパラメーターをコンマで区切ります。 パラメーターは、任意の順序で指定することができます。
- 32K
- 入力データ・セット SYSUT1 のページ・サイズが 32 KB であることを指定します。このオプションが
指定されていて、SYSUT1 データ・セットのページ・サイズが 32 KB ではない
場合は、DSN1COMP は予測不能の結果になります。
パフォーマンス上推奨されるオプションは、PAGESIZE(32K) です。
- PAGESIZE
- SYSUT1 によって定義されている入力データ・セットのページ・サイズを指定します。有効な
ページ・サイズは 4K、8K、16K、または 32K です。
誤ったページ・サイズを指定した場合は、DSN1COMP が予測不能の結果をもたらす恐れがあります。
PAGESIZE を省略すると、DSN1COMP はページ・サイズを入力データ・セットから判別しようと します。DSN1COMP が入力ページ・サイズを判別することができなかった場合は、Db2® によって エラー・メッセージが発行されます。これが起きる可能性があるのは、入力データ・セットの中にヘッダー・ページが含まれていない場合、またはヘッダー・ページ内のページ・サイズ・フィールドに無効なページ・サイズが入っている場合です。
この値に関する情報を、入力データ・セットのヘッダー・ページで使用できる場合、ヘッダー・ページ情報がデフォルトです。
- DSSIZE(integer G)
- 入力データ・セットのデータ・セット・サイズをギガバイト単位で指定し
ます。DSSIZE を省略した場合、Db2 はデータ・セット・ヘッダー・ページからデータ・セット・サイズを取得します。
DSSIZE を指定する場合、integer は、表スペースの定義時に指定された DSSIZE 値と一致する必要があります。
- LARGE
- 入力データ・セットが LARGE オプションで定義された表スペースである
ことを指定します。LARGE を指定すると、Db2 は、そのデータ・セットの境界は 4 GB 境界であると見なし
ます。
LARGE を用いて定義された表スペースを 指定する方法として推奨されるのは、DSSIZE(4G) です。
LARGE または DSSIZE(4G) オプションが必要であるのに省略 されている場合、または、LARGE で定義されていない表スペースに対して LARGE が指定されている場合、 DSN1COMP の結果は予測不能です。
この値に関する情報を、入力データ・セットのヘッダー・ページで使用できる場合、ヘッダー・ページ情報がデフォルトです。
- NUMPARTS(integer)
- 入力データ・セットに関連付けられたパーティションの数を指定します。
有効な指定範囲は、1 から 4096 までです。NUMPARTS を省略す
るか、NUMPARTS を 0 として指定すると、DSN1COMP は入力ファイル
がパーティション化されていないと見なします。64 より大きい数が指定されていると、DSN1COMP は、
LARGE キーワードが指定されていなくても、データ・セットは LARGE オプションで定義されたパーティション化表スペース用のデータ・セットであると
見なされます。
DSN1COMP が、NUMPARTS パラメーターを必ず妥当性検査できるとは限りません。 このパラメーターの指定が間違った場合は、DSN1COMP が予測不能の結果をもたらす恐れがあります。
DSN1COMP は、複数のパーティションが入っているイメージ・コピーを検出すると、終了し、 メッセージ DSN1946I を出します。先頭パーティションについての圧縮の報告書は発行されます。
ターゲット表スペースがユニバーサル表スペースの場合、このパラメーターは使用されません。代わりに DSSIZE が使用されます。
このパラメーターは非推奨になりました。
- FREEPAGE(integer)
- 節減するページの比率を計算する際に、フリー・スペースのページを残す頻度を指定
します。0 から 255 までの整数を指定しなければなりません。0 を指定すると、節減するページの比率を報告する際に、フリー・スペースとして含まれるページはありません。
それ以外の場合は、n ページごとに 1 つのフリー・ページが組み込まれます。
ここで、n は、指定された整数です。
デフォルト値は 0 です。
SQL ステートメント CREATE TABLESPACE または ALTER TABLESPACE の FREEPAGE オプションに 指定したものと同じ値を指定してください。
- PCTFREE(integer)
- 節減されるページの比率を計算する際、
各ページのフリー・スペースとして残す比率を指示します。0 から 99 の範囲の
整数を指定する必要があります。節減を計算する際に、DSN1COMP は、
各ページに少なくとも n % のフリー・スペース
を許します。ここで、n は、指定した整数です。
デフォルト値は 5 です。
SQL ステートメント CREATE TABLESPACE または ALTER TABLESPACE の PCTFREE オプションに 指定したものと同じ値を指定してください。
- FULLCOPY
- データ・セットの Db2 フル・イメージ・コピー (DFSMSdss 並行コピー ではなく) を入力として使用することを指定します。入力がフル・イメージ・コピーであるのにこのパラメーターを 省略すると、エラー・メッセージが出されるか、あるいは予期せぬ結果となることがあります。 このデータがパーティション化されている場合は、NUMPARTS パラメーターも指定して、パーティション 数を示します。
- REORG
- REORG ユーティリティーが達成する節減に匹敵するような、圧縮による節減の見積もりを提供します。 このキーワードを指定しない場合は、LOAD ユーティリティーで達成する圧縮による節減と 似たものになります。
- ROWLIMIT(integer)
- 圧縮の見積もりを行うための評価対象となる最大行数を指定します。
このオプションによって、DSN1COMP は入力データ・セットのすべての行を調べずに済みます。
有効な指定範囲は、1 から 99000000 までです。
このオプションを使用して、DSN1COMP が必要とする経過時間とプロセッサー時間を制限します。 表スペースの最初の 5 から 10 MB を分析すると、圧縮による節減の見積もり用に、 かなり代表的なサンプルが得られます。 したがって、DSN1COMP を表スペースの先頭 5 から 10 MB に限定する ROWLIMIT 値を指定します。 例えば、表スペースの行の長さが 200 バイトの場合、ROWLIMIT(50000) と 指定すると、DSN1COMP は、おおよそ 10 MB の表スペースを分析することになります。
- MAXROWS(integer)
- 節約されたページの比率を計算する場合、DSN1COMP に検討させる行の最大数を
指定します。指定する値は 1 ~ 255 の範囲内の整数でなければなりません。
デフォルト値は 255 です。
SQL ステートメント CREATE TABLESPACE または ALTER TABLESPACE の MAXROWS オプションに 指定したものと同じ値を指定してください。
- EXTNDICT(dictionary-name)
- DSN1COMP により作成されるコンプレッション・ディクショナリーの外部コピーの名前を指定します。dictionary-name は、以下のようにする必要があります。
- 8 バイトである
- 大文字の英数字のみ含まれる
- 英字で始める
コンプレッション・ディクショナリーの外部コピーは、主に IBM® Data Encryption for IMS™ and Db2 ツールが使用します。
EXTNDICT を指定する場合、DSN1DICT DD ステートメントを、DSN1COMP を実行するための JCL に含める必要があります。
- LEAFLIM(integer)
- 圧縮の見積もりを決定する際に評価する索引リーフ・ページの数
を指定します。このオプションが指定されていると、DSN1COMP は入力データ・セット内のすべての索引リーフ・ページ
を処理しなくても済みます。
有効な指定範囲は、1 から 99000000 までです。
LEAFLIM パラメーターが指定されて いない場合、索引全体がスキャンされ、すべてのリーフ・ページが検査されます。
圧縮索引内では、 リーフ・ページのみが圧縮されます。他のすべてのページ・タイプは圧縮されていないままになります。
