DSNADMSB プログラムのパラメーター

DSNADMSB プログラムのパラメーターは、プログラムによって収集される情報の種類、および情報の書き込み先となる宛先を決定します。

プログラム固有のプログラミング・インターフェース情報の開始

DSNADMSB からの出力は、主に IBM® ソフトウェア・サポートが使用するためのものです。この出力は、適宜変更されることがあります。

すべてのパラメーターは定位置であり、必須です。パラメーター値を NULL にすることはできません。 INPUTP DD ステートメントに関連付けられるデータ・セットの中でパラメーターを指定します (各レコードに 1 つのパラメーター値)。 1 つのパラメーターを複数のレコードに適用することができます。 最初のレコードの後に続くすべてのレコードの第 1 列に正符号 (+) を指定することで、パラメーターのテキストが継続していることを示します。 DSNADMSB は、すべての行の末尾にあるブランクを切り取ります。 DSNADMSB はパラメーターのテキストの中にあるブランクは切り取りません。

パラメーターの説明

table-creator
DSNADMSB による情報収集の対象となる表、表リスト・テーブル (LIST_TABLE-list-table)、または PLAN_TABLE の修飾子。 table-creator の最大長は 128 バイトです。 table-creator を NULL にすることはできません。
table-name
値は次のいずれか。
  • table-creator を修飾子とする単一ユーザー・オブジェクトの名前。 この名前は、以下のいずれかの種類のオブジェクトを識別する必要があります。
    • 基本表
    • ビュー
    • 別名
    • クローン表
    • 作成された一時表
    • 履歴表
    • マテリアライズ照会表
    • XML 列に関する暗黙的に作成された表
  • LIST_TABLE-list-table

    list-table は、table-creator を修飾子とするローカル・サブシステム上の Db2® 表を識別します。この表には CREATOR および TABLE という名前の 2 つの列が含まれる必要があります。 list-table の各行は、DSNADMSB による情報収集の対象となる表またはビューを識別します。 LIST_TABLE-list-table で指定される表の種類は、table-name で指定できる表の種類と同じです。

  • PLAN_TABLE

    情報収集の対象となる表を決定するために table-creator.PLAN_TABLE および plan-info パラメーターを DSNADMSB で使用することを指定します。 参照される PLAN_TABLE は基本表でなければなりません。

    推奨事項: PLAN_TABLE を指定する場合には、EXPLAIN の実行前にビュー参照表 DSN_VIEWREF_TABLE が存在することを確認してください。 情報収集の対象となる照会にビューが含まれている場合には、DSN_VIEWREF_TABLE の存在が特に重要になります。 DSN_VIEWREF_TABLE が存在し、EXPLAIN によってそれに既にデータが入れられている場合には、DSNADMSB を使って (すべてのビュー従属関係に関するデータを収集する代わりに) 該当する照会に固有のビュー・データを集めることができます。 DSN_VIEWREF_TABLE は、プラン表と同じ修飾子を持つ必要があります。 この修飾子は、最初の DSNADMSB 入力パラメーター table-creator です。

table-name の最大長は 128 バイトです。

表名が区切り ID である場合は、table-name の中に区切り文字を含めないでください。

catalog-creator
Db2 カタログの修飾子、または DEFAULT (カタログ修飾子が SYSIBM であることを示します)。

catalog-creator の最大長は 128 バイトです。

plan-info
table-name で指定される表が PLAN_TABLE である場合、plan-info は以下の形式の値、または NONE です。
program-begin-queryno-end-queryno

これらの変数の意味は以下のとおりです。

program
PLAN_TABLE の PROGNAME 列からの 1 つの値、または PLAN_TABLE 内の一連の PROGNAME 値を指定するパターン。 LIKE 述部で有効な任意のパターンを指定することができます。 program は、DSNADMSB による PLAN_TABLE 情報収集の対象となるプログラムまたはパッケージを表します。
begin-queryno
PLAN_TABLE の QUERYNO 列からの値。 この値は、DSNADMSB による PLAN_TABLE 情報収集の対象となる最も低いステートメント番号を表します。
end-queryno
PLAN_TABLE の QUERYNO 列からの値。 この値は、DSNADMSB による PLAN_TABLE 情報収集の対象となる最も高いステートメント番号を表します。

table-name で PLAN_TABLE が指定されない場合、plan-info の値は NONE でなければなりません。

plan-info の最大長は 150 バイトです。

collect-ddl
table-name で指定される入力表/ビューの作成に使われたデータ定義言語ステートメント、および関連するオブジェクトのデータ定義言語ステートメントを DSNADMSB によって戻すかどうかを指定します。 collect-ddl の長さは 1 バイトです。

入力表が PLAN_TABLE でない場合、可能な値は次のとおりです。

N
オブジェクトを作成したデータ定義言語ステートメントを戻しません。
Y
以下のものを作成したデータ定義言語ステートメントを戻します。
  • 入力オブジェクト
  • 入力オブジェクトを参照する外部キー
  • 入力オブジェクトのビュー
0
以下のものを作成したデータ定義言語ステートメントを戻します。
  • 入力オブジェクト。 入力オブジェクトのビューや、入力オブジェクトを参照する外部キーを作成するステートメントは、収集されません。
1
以下のものを作成したデータ定義言語ステートメントを戻します。
  • 入力オブジェクト
  • 入力オブジェクトのビュー
2
以下のものを作成したデータ定義言語ステートメントを戻します。
  • 入力オブジェクト
  • 入力オブジェクトを参照する外部キー
3
以下のものを作成したデータ定義言語ステートメントを戻します。
  • 入力オブジェクト
  • 入力オブジェクトを参照する外部キー
  • 入力オブジェクトのビュー
  • 入力オブジェクトに依存する、他のオブジェクト (マテリアライズ照会表など)

このオプションを指定すると、結果として大量のデータが生成される可能性があります。 IBM ソフトウェア・サポートから依頼されたデータ収集に関しては、このオプションを使用しないでください。

4
オプション Y が指定された場合に戻されるのと同じデータ定義言語ステートメントを戻します。

入力表が PLAN_TABLE である場合、可能な値は次のとおりです。

N
オブジェクトを作成したデータ定義言語ステートメントを戻しません。
Y
以下のものを作成したデータ定義言語ステートメントを戻します。
  • plan-info によって識別されるオブジェクト
  • plan-info によって識別されるオブジェクトを参照する外部キー
  • DSN_VIEWREF_TABLE が存在し、かつそれにデータが入っている場合には、plan-info で識別される照会の処理に使われるビューまたはマテリアライズ照会表
  • DSN_VIEWREF_TABLE が存在しない場合は、plan-info によって識別されるオブジェクトのビュー。DSN_VIEWREF_TABLE を使用できない場合には、DSN_VIEWREF_TABLE を使用できる場合に比べて DSNADMSB でのデータ収集に長い時間がかかります。
0
以下のものを作成したデータ定義言語ステートメントを戻します。
  • plan-info によって識別されるオブジェクトのみ。 plan-info によって識別されるオブジェクトのビューや、それらのオブジェクトを参照する外部キーを作成するステートメントは、収集されません。
1
以下のものを作成したデータ定義言語ステートメントを戻します。
  • plan-info によって識別されるオブジェクト
  • DSN_VIEWREF_TABLE が存在し、かつそれにデータが入っている場合には、plan-info で識別される照会の処理に使われるビューまたはマテリアライズ照会表
  • DSN_VIEWREF_TABLE が存在しない場合は、plan-info によって識別されるオブジェクトのビュー。DSN_VIEWREF_TABLE を使用できない場合には、DSN_VIEWREF_TABLE を使用できる場合に比べて DSNADMSB でのデータ収集に長い時間がかかります。
2
以下のものを作成したデータ定義言語ステートメントを戻します。
  • plan-info によって識別されるオブジェクトを参照する外部キー
3
以下のものを作成したデータ定義言語ステートメントを戻します。
  • plan-info によって識別されるオブジェクト
  • plan-info によって識別されるオブジェクトを参照する外部キー
  • plan-info によって識別されるオブジェクトのビュー
  • plan-info によって識別されるオブジェクトに依存する、他のオブジェクト (マテリアライズ照会表など)

このオプションを指定すると、結果として大量のデータが生成される可能性があります。 IBM ソフトウェア・サポートが問題分析を行う場合は、指示された場合以外、このオプションを指定しないでください。

4
以下のものを作成したデータ定義言語ステートメントを戻します。
  • plan-info によって識別されるオブジェクト
  • plan-info によって識別されるオブジェクトを参照する外部キー
  • plan-info によって識別されるオブジェクトのビュー

このオプションは DSN_VIEWREF_TABLE からの情報を使用しません。 オプション Y を指定し、かつ DSN_VIEWREF_TABLE が使用可能な場合に比べると、オプション 4 を指定した場合には DSNADMSB でのデータ収集に長い時間がかかります。

collect-stats
table-name で指定される表および関連オブジェクトについての統計情報を DSNADMSB によって Db2 カタログ表から戻すかどうかを指定します。 可能な値は、以下のとおりです。
Y
Db2 カタログから表についての統計情報を戻します。
N
Db2 カタログから表についての統計情報を戻しません。
重要: collect-stats 値を Y に設定すると、大量のデータが生成される可能性があります。 Db2 カタログ表から実際に統計情報を得る必要がある場合を除いて、collect-stats を N に設定してください。

collect-stats の長さは 1 バイトです。

collect-colstats
table-name で指定される表の列および関連オブジェクトについての統計情報を DSNADMSB によって Db2 カタログ表から戻すかどうかを指定します。可能な値は、以下のとおりです。
Y
Db2 カタログから列についての統計情報を戻します。
N
Db2 カタログから列についての統計情報を戻しません。
重要: collect-colstats 値を Y に設定すると、大量のデータが生成される可能性があります。 Db2 カタログ表から実際に統計情報を得る必要がある場合を除いて、collect-colstats を N に設定してください。

collect-colstats の長さは 1 バイトです。

edit-ddl
データ定義言語ステートメントを IBM ソフトウェア・サポートでより簡単に実行できるようにするために、DSNADMSB で生成されるデータ定義言語ステートメントを修正するかどうかを指定します。DSNADMSB は、例えば次のような変更を行います。
  • STOGROUP を SYSDEFLT に設定する
  • PRIQTY および SECQTY を最小値に設定する
  • DEFINE を NO に設定する
  • 外部キー定義をコメント化する
可能な値は、以下のとおりです。
Y
DSNADMSB によって生成されるデータ定義言語ステートメントを編集します。

table-name で指定される表に入れられるデータを IBM ソフトウェア・サポートに送らない場合は、値 Y が推奨されます。

N
DSNADMSB によって生成されるデータ定義言語ステートメントを編集しません。

edit-ddl の長さは 1 バイトです。

edit-version-mode
情報の収集時に、現在実行されているバージョンおよびモードとは異なる Db2 for z/OS® のバージョンおよびモード用に出力をフォーマット設定する必要があることを指定します。バージョン番号およびモードを指定する必要があります。あるいは、出力が別のフォーマットに変換されないように NONE を指定することができます。

有効なモードの値は、C (変換モードの場合) および N (新規機能モードの場合) です。例えば、 ご使用の Db2 サブシステムが DB2® 10 変換モードで 実行されていて、DB2 9 新規機能モードの出力を生成したい場合は、9-N を指定します。

これは、タイプ CHAR(4) の入力パラメーターで、NULL にすることはできません。

partition-rotation
パーティション化表で発生した循環の量を DSNADMSB によって検査するかどうかを指定します。 DSNADMSB は、論理パーティションを物理パーティションと同期するために必要なパーティション循環の数を判別します。 可能な値は、以下のとおりです。
Y
パーティション循環の量を検査します。

Y はパーティション化表に関してのみ有効です。

N
パーティション循環の量を検査しません。

partition-rotation の長さは 1 バイトです。

output-method
DSNADMSB 出力の宛先のタイプを指定します。 可能な値は、以下のとおりです。
R
出力はジョブ・ストリームに戻されます。 ほとんどの場合、R を使用してください。
Q
出力は、DSNADMSB が作成するデータ・セットに戻されます。 output-info パラメーターの中で、これらのデータ・セットの修飾子の名前と 1 次および 2 次割り振り数量を指定してください。
重要: データ・セットは、スクラッチ・パック上に作成される一時データ・セットです。 z/OS システムの構成方法によっては、短時間経過したらデータ・セットが削除されることがあります。
N
出力は、WLM 環境始動プロシージャーによって割り振られる既存のデータ・セットに戻されます。 output-info パラメーターでデータ・セット名を指定します。
D
出力は、DSNADMSB が作成するデータ・セットに戻されます。 output-info パラメーターの中で、これらのデータ・セット用のデータ・セット名と 1 次および 2 次割り振り数量を指定してください。

output-method の長さは 1 バイトです。

output-info
出力データ・セット情報を指定します。 output-method の値によって、情報は以下のように異なります。
output-method の値 output-info の値
R NONE
Q ストリングの形式:
qualifier-primary-secondary
qualifier
最大 29 バイトまでのストリング、または DEFAULT。 DSNADMSB は、出力データ・セットのタイプを定義するストリングを付加します。 qualifier が DEFAULT でない場合、qualifier は z/OS データ・セット名の規則に従う必要があります。qualifier が DEFAULT である場合、DSNADMSB は以下の形式の qualifier 値を生成します。
PMnnnnn.Dyymmdd.Thhmmss

nnnnn は PMR 番号です。 yymmdd および hhmmss は DSNADMSB が実行された日時です。

DSNADMSB によって qualifier に付加されるストリングは、次のとおりです。

  • .DDL - ユーザー表または PLAN_TABLE 用のデータ定義ステートメントを含んでいるデータ・セット
  • 変更の始まり.SQL - PLAN_TABLE、 DSN_PROFILE_TABLE、 DSN_PROFILE_ATTRIBUTES、および SYSACCELERATORS にデータを入れる SQL ステートメントを含んでいるデータ・セット変更の終わり
  • .STATS - 表についての統計情報を Db2 カタログ表に入れる SQL ステートメントを含んでいるデータ・セット
  • .COLST - 列についての統計情報を Db2 カタログ表に入れる SQL ステートメントを含んでいるデータ・セット
  • 変更の始まり.EXPL - 表 PLAN_TABLE、 DSN_PREDICAT_TABLE、 DSN_DETCOST_TABLE、 DSN_PROFILE_TABLE、 DSN_PROFILE_ATTRIBUTES、および SYSACCELERATORS からの出力を含んでいるデータ・セット変更の終わり
  • .PARM - サブシステム・パラメーター設定を含んでいるデータ・セット
primary
出力データ・セット用の 1 次割り振り数量、または DEFLT。 DEFLT を指定した場合、1 次割り振り数量は 200 トラックです。
secondary
出力データ・セット用の 2 次割り振り数量、または DEFLT。 DEFLT を指定した場合、2 次割り振り数量は 200 トラックです。
N ストリングの形式:
ddldd-sqldd-statsdd-colstdd-colstdd-parmdd
ストリングの各部分は、ADMIN_INFO_SQL ストアード・プロシージャーの実行場所である WLM 環境用の WLM 始動プロシージャーで定義されたデータ・セットの DD 名です。 DD 名は次のとおりです:
  • ddldd - ユーザー表または PLAN_TABLE 用のデータ定義ステートメントを含んでいるデータ・セット
  • 変更の始まりsqldd - PLAN_TABLE、 DSN_PROFILE_TABLE、 DSN_PROFILE_ATTRIBUTES、および SYSACCELERATORS にデータを入れる SQL ステートメントを含んでいるデータ・セット変更の終わり
  • statsdd - 表についての統計情報を Db2 カタログ表に入れる SQL ステートメントを含んでいるデータ・セット
  • colstdd - 列についての統計情報を Db2 カタログ表に入れる SQL ステートメントを含んでいるデータ・セット
  • 変更の始まりexpldd - 表 PLAN_TABLE、 DSN_PREDICAT_TABLE、 DSN_DETCOST_TABLE、 DSN_PROFILE_TABLE、 DSN_PROFILE_ATTRIBUTES、および SYSACCELERATORS からの出力を含んでいるデータ・セット変更の終わり
  • parmdd - サブシステム・パラメーター設定を含んでいるデータ・セット
D 次の形式のレコード: 変更の始まり
DDL;dsname;volser;allocunits;primary;secondary-
+SQL;dsname;volser;allocunits;primary;secondary-
+STATS;dsname;volser;allocunits;primary;secondary-
+COLST;dsname;volser;allocunits;primary;secondary-
+EXPL;dsname;volser;allocunits;primary;secondary-
+PARM;dsname;volser;allocunits;primary;secondary
変更の終わり

変更の始まり正符号 (+) は、output-info 値の一部ではありません。新規レコードに output-info 値を続けるときに、列 1 に正符号 (+) を付ける必要があります。変更の終わり

ストリング内の項目の意味は以下のとおりです。
DDL、SQL、STATS、COLST、EXPL、PARM
DSNADMSB によりデータ・セットに書き込まれる出力のタイプを次のように識別します:
  • DDL - ユーザー表または PLAN_TABLE 用のデータ定義ステートメントを含んでいるデータ・セット
  • 変更の始まりSQL - PLAN_TABLE、 DSN_PROFILE_TABLE、 DSN_PROFILE_ATTRIBUTES、および SYSACCELERATORS にデータを入れる SQL ステートメントを含んでいるデータ・セット変更の終わり
  • STATS - 表についての統計情報を Db2 カタログ表に入れる SQL ステートメントを含んでいるデータ・セット
  • COLST - 列についての統計情報を Db2 カタログ表に入れる SQL ステートメントを含んでいるデータ・セット
  • 変更の始まりEXPL - 表 PLAN_TABLE、 DSN_PREDICAT_TABLE、 DSN_DETCOST_TABLE、 DSN_PROFILE_TABLE、 DSN_PROFILE_ATTRIBUTES、および SYSACCELERATORS からの出力を含んでいるデータ・セット変更の終わり
  • PARM - サブシステム・パラメーター設定を含んでいるデータ・セット
dsname
DSNADMSB が割り振るデータ・セットの完全修飾名、または DEFAULT。 DEFAULT を指定した場合、データ・セット名は次のような形式になります。
PMnnnnn.Dyymmdd.Thhmmss.Vn.COLST
PMnnnnn.Dyymmdd.Thhmmss.Vn.DDL
PMnnnnn.Dyymmdd.Thhmmss.Vn.EXPL
PMnnnnn.Dyymmdd.Thhmmss.Vn.PARM
PMnnnnn.Dyymmdd.Thhmmss.Vn.SQL
PMnnnnn.Dyymmdd.Thhmmss.Vn.STATS

nnnnn は PMR 番号です (ブランチ・コードと国別コードはありません)。

yymmdd は DSNADMSB が実行された日付、hhmmss はその時刻です。

n はリリース標識です。

volser
データ・セットの作成場所であるボリューム通し番号。
allocunits
有効値は TRK または CYL です。
primary
出力データ・セットの 1 次割り振り数量。
secondary
出力データ・セットの 2 次割り振り数量。

output-info の最大長は 1024 バイトです。

pmr-info
データ収集の対象となる PMR の番号。以下の形式です。
number.branch-code.country-code

プログラム固有のプログラミング・インターフェース情報の終了