db2support - 問題分析および環境収集ツール・コマンド

許可

最も完全な出力を得るには、 インスタンス所有者などの SYSADM 権限でこのコマンドを実行します。 SYSADM 権限がない場合、データ収集アクションによっては、報告が少なくなったり出力が少なくなったりするものもあります。

必要な接続

なし

コマンド構文

Archive Mode

Collection Mode

event-monitor-parameters

Installation collection mode

Extraction Mode

コマンド・パラメーター

出力パス (output_path)

圧縮されたアーカイブ・ファイルを作成または解凍するパスを指定します。 このパスは、ユーザーの作成ファイルをアーカイブに含めるために配置しなければならないディレクトリ、または-unzipパラメーターが指定されたときのファイル抽出ディレクトリです。 このパラメーターが指定されていないときは、現行ディレクトリーが使用されます。

-A archive_path | -archive archive_path

このパラメーターは、diagpath構成パラメーターに指定ディレクトリーのすべてのデータを、指定アーカイブ・パスにアーカイブします。 新規ディレクトリーは、DB2DUMP にシステム・ホスト名とタイム・スタンプが付加された名前で、指定されたアーカイブ・パスに作成されます。例えば、DB2DUMP_systemhostname_2009-01-12-12.01.01 となります。

また、このパラメーターは、alt_diagpath 構成パラメーターに指定されたディレクトリーのすべてのデータを、指定アーカイブ・パスにアーカイブします。 このディレクトリー名は ALT_DB2DUMPです。 また、events/ サブディレクトリーのファイルはALT_EVENTSディレクトリーにアーカイブされ、stmmlog/サブディレクトリーのファイルはALT_STMMディレクトリーにアーカイブされます。

このパラメーターは、Windows オペレーティング・システムでは使用できません。

-aem

db2caem コマンドを実行してアクティブ・イベント・モニターを作成し、SQL ステートメントのデータをキャプチャーできます。

以下の db2support オプションにより、 db2caem にパラメーターを渡したり、実行方法を操作したりできます。

-d

データベース名。 これは必須です。

-sf

SQL ステートメントが含まれているファイル。 このパラメーターまたは-stパラメーターを提供しなければなりません。

-st

SQL ステートメント自体。 このパラメーターまたは-sfパラメーターを提供しなければなりません。

-td

ステートメントの終了文字。

-compenv

コンパイル環境。

-tbspname

表スペース名。

-ro

この REOPT ONCE オプションは、照会の EXPLAIN 時に使用します。

-u

ユーザー名。

-p

パスワード。

-seオプションは -aemと互換性がありません。

-sf オプションと -st オプションを使用すると、db2support はオプティマイザー・モードになります。

db2caem によって作成されたアクティビティー・イベント・モニターと表は、終了時に削除されます。

-alldbs | -alldatabases

コマンドが、データベース・ディレクトリーにあるすべてのデータベースのデータベース関連情報を収集するように指定します。 コマンドは、最大 100 個のデータベースのデータベース情報を収集します。 -alldbsパラメーターは、オプティマイザー・モードでまたは-preupgradeパラメーターと一緒に使用できません。 -alldbsパラメーターと-dパラメーターは相互に排他的です。

-nco | -noconnect

指定のデータベースへの接続を試みないことを指定します。

-c | -connect

指定のデータベースへの接続を試みることを指定します。 データベースを指定する場合は、このコマンド・パラメーターがデフォルトで組み込まれます。

-B | -basic

収集をオプティマイザー情報のみに制限します。 db2supp_opt.zipファイルの情報以外の情報は収集されません。 -basicパラメーターは、-st、 -sf、または-seパラメーターと一緒に使わなければなりません。そうしないと、構文エラーが返されます。

-c | -connect

指定のデータベースに接続します。

-cd | -curdegree

使用する CURRENT DEGREE 特殊レジスターの値を指定します。 デフォルトは、dft_degree データベース構成パラメーターの値です。

-cfg

構成情報を収集し、その他のサポート関連データをすべて除外します。 このパラメーターは、パラメーター -c、 -connect、 -d、 -database、 -m、 -html、 -n、 -number、 -o、 -output、 -p、 -password、 -u、 -user、 -v、 -verboseのみと組み合わせることができます。

-cfs

クラスタファイルシステム追加の診断データが生成された.zipファイルにパッケージ化されることを指定します。 このパラメーターは追加のクラスター・ファイル・システム・データのみを収集しますが、これにはスペースが大量に消費されたり時間がかかったりします。

-cl | -collect

戻されるパフォーマンス情報のレベルを指定します。 有効な値は以下のとおりです。

0 = collect only catalogs, db2look, dbcfg, dbmcfg, db2set
1 = collect 0 plus exfmt
2 = collect 1 plus .db2service (this is the default)
3 = collect 2 plus db2batch

注: -st、 -sf、または -seを指定せずにイベント・モニター・パラメーター (-actevm、 -appid、 -uowid、 -actid) を指定した場合、有効な収集レベルは 1 で、 db2caem 情報のみが収集されます ( db2exfmt 収集は行われません)。

-センチメートル

クラスター・マネージャーの追加診断データが、生成される .zip ファイルにパッケージされるように指定します。 このパラメーターは追加のクラスター・マネージャー・データのみを収集しますが、これにはスペースが大量に消費されたり時間がかかったりします。

-co

データベース内のすべての表のカタログを収集します。 デフォルトでは、問題のある照会で使用される表のカタログ情報のみを収集します。

-compenv コンパイル環境ファイル (compilation-environment-file)

db2caem コマンドの実行時に使用されるコンパイル環境の名前が含まれているファイルの名前を指定します。 コンパイル環境 (comp_env_desc) は BLOB データ・タイプであり、入力としてファイルにより指定します。 パラメーターが指定されない場合、db2caem を実行する際にはデフォルトのコンパイル環境が使用されます。

-cs | -curschema

ステートメント内で修飾されていない表名を修飾するために使われる現行スキーマを指定します。 デフォルト値は、現行セッション・ユーザーの許可 ID です。

-C | -compress

アーカイブ圧縮を使用可能にします。 デフォルトで、アーカイブ・データは単一ファイルに圧縮されます。 アーカイブ圧縮はアーカイブ・モードでのみ使用可能であるため、-Aパラメーターも指定しなければなりません。指定しないと、構文エラーが返されます。

tar

tar(テープ・アーカイブ) コマンドでファイルをアーカイブすることを指定します。 tar パラメーターは、UNIX および Linux® オペレーティング・システムでサポートされます。

tgz

ファイルを tar コマンドを使用してアーカイブし、gzip コマンドを使用して圧縮するように指定します。 tgz パラメーターは、UNIX および Linux オペレーティング・システムでサポートされます。

-d database_names | -database database_names

データが収集されているデータベースの名前を指定します。 複数のデータベースからデータの収集を行うために、複数のデータベース名を指定できます。 データ収集を行うデータベースの名前を最大 100 個指定できます。

デフォルトでは、指定のデータベースに接続するための試行を行います。 この動作をオーバーライドするには、-noconnect パラメーターまたは-ncoパラメーターを指定してください。

複数のデータベースを指定する場合は、db2support コマンドをオプティマイザー・モードで実行することも -preupgrade パラメーターを指定して実行することもできません。

-nco | -noconnect

指定のデータベースへの接続を試みないことを指定します。

-c | -connect

指定のデータベースへの接続を試みることを指定します。 指定のデータベースへの接続を試みることを指定します。 データベースを指定すると、このコマンド・パラメーターがデフォルトで組み込まれます。

event-monitor-parameters

次のパラメーターは、アクティビティー・イベント・モニター・データが収集される SQL ステートメントを一意的に示します。 これらのパラメーターは、一緒に指定する必要があります。

-actevm activity_event_monitor_name

activitystmt 論理グループ化が収集対象データを含む既存のアクティビティー・イベント・モニターの名前を指定します。

-appid application_id

集まったアクティビティーの発行アプリケーションを独特に識別するアプリケーション ID (appl_id 監視要素) を指定します。

-uowid uow_id

データ収集作業単位のID (uow_id 監視要素) を指定します。 作業単位 ID は、特定のアプリケーション内のみで固有です。

-actid activity-id

データを収集するアクティビティーID (activity_id監視要素) を指定します。 アクティビティー ID は、指定された作業単位内のみで固有です。

-extenddb2batch

-ol または -optlevel パラメーターを使用して指定したすべての最適化レベルの db2batch コマンド情報をキャプチャーすることを指定します。 -extenddb2batchパラメーターを指定する場合は、少なくとも1 つの値を-olパラメーターに指定し、-clパラメーター値を3 に指定ししなければなりません。 このように指定しない場合、db2support コマンドは構文エラーを返します。

-fodc

FODC ディレクトリーと db2diag ログ・ファイルのみを収集することを指定します。 ディレクトリーを指定しない場合は、db2support コマンドによってすべての FODC ディレクトリーのリストが表示され、そこから選択できます。 ディレクトリーは使用時のタイム・スタンプに基づいて昇順の日時順にリストされるので、使用された日時が最近のディレクトリーほど目につきやすい位置に表示されます。

db2support コマンドが収集できる FODC ディレクトリーは、コマンドが実行された物理データベース・ホスト上にあるものだけです。 -hostまたは-memberパラメーターを使用して、FODCディレクトリーをリモートで収集できます。 ただし、FODCディレクトリにはコアファイルなどの大きなファイルが含まれる可能性があるため、FODCディレクトリが存在するホストで-fodcパラメータを実行するようにお勧めします。

時間間隔パラメーター (-t または -time) あるいは履歴パラメーター (-H または -history) を指定できますが、指定した FODC ディレクトリーが指定した時間フレームに含まれていない場合、db2support は指定された FODC ディレクトリーを収集しません。 -tパラメーターまたは-Hパラメーターが指定されない場合、-fodcパラメーターは14日以内にFODCディレクトリーを収集します。

パラメーターを使用する場合、アーカイブ（-Aまたは-archive）または基本（-Bまたは-basic）-fodcパラメーターを指定できません。

トラップ | パニック | BadPage | ハング | IndexError | パフォーマンス | DBMarkedBad

収集する FODC ディレクトリーのカテゴリーを指定します。

list_of_FODC_directories

既存の FODC ディレクトリーのコンマ区切りリスト。 複数ホスト環境のすべてのFODC ディレクトリーを表示するには、-host all オプションを指定してください。

-fodcpath fodc_path_name

db2support コマンドによる FODC パッケージ検索の対象にできる既存ディレクトリーの絶対パスの名前を指定します。 db2support コマンドは、FODC パッケージを収集するために以下のパスを検索します。

• diagpathとalt_diagpathデータベース・マネージャー構成パラメーターに指定された診断データ・ディレクトリー
• DB2FODC レジストリー変数のインスタンス・レベルのFODCPATHパラメーター設定
• そのマシンの各メンバーの FODCPATH 設定
• メモリー内の db2pdcfg コマンド設定
• -fodcpathパラメーターを使用して指定するfodc_path_name 変数の値

-F | -full

db2support 情報およびオプティマイザー固有の情報をすべて、何も除外せずにキャプチャーすることを指定します。

-fp | -funcpath

修飾されていないユーザー定義関数およびタイプを解決するために使う関数パス特殊レジスターの値を指定します。 デフォルト値は SYSIBM 、 SYSFUN、 SYSPROC 、 Xです。ここで、X は、二重引用符に区切られた USER 特殊レジスターの値です。

-h | -help

ヘルプ情報を表示します。 このパラメーターを指定すると、他のすべてのパラメーターは無視され、 ヘルプ情報だけが表示されます。

-H history_period | -history history_period

収集されるデータを特定の時間間隔に制限します。 history_period 変数は、数値と時刻タイプを使用して指定できます。 使用できるタイプは以下のとおりです。

d

日。

h

時間。

m

分。

s

秒。

オプションで、開始時刻の値をコロンで区切って指定できます。開始時刻の値はタイム・スタンプ形式で指定します。 タイム・スタンプの形式は、 YYYY 年-MM-DD とは-HH.Mm.SS.NNN です。

ここで、

YYYY

年を指定します。

MM

月 (01 から 12 まで) を指定します。

DD

日 (01 から 31 まで) を指定します。

hh

時間 (00 から 23 まで) を指定します。

mm

分 (00 から 59 まで) を指定します。

ss

秒 (00 から 59 まで) を指定します。

nnnnnn

UNIX オペレーティング・システムの場合はマイクロ秒、Windows オペレーティング・システムの場合はミリ秒を指定します。

年フィールドに続くフィールドの一部またはすべてを省略できます。 省略されたフィールドには、デフォルト値が使用されます。 月および日のデフォルト値は 1 で、他のすべてのフィールドのデフォルト値は 0 です。

数値と時間のタイプは正または負にすることができ、プラス記号（+）またはマイナス記号（-）で指定します。 数値と時間タイプのみを指定する場合、デフォルトは負になります。 数値、時刻タイプ、開始時刻の値を指定した場合、デフォルトは正になります。 例えば、-history 6dは過去6 日間のデータを収集し、-history 6d:2013は2013年の最初の6 日間のデータを収集します。

このパラメーターは、-timeまたは-tパラメーターと一緒に使用できません。 -Hパラメーターまたは-tパラメーターが指定されない場合、デフォルト値は14日です。

-ホスト

コマンド発行先ホスト (複数も可) を指定します。 このパラメーターが指定されていない場合、コマンドは、-fodcパラメーターを除くすべてのホストでデフォルトに発行されます。

すべて

コマンドが、すべてのホストに対して発行されるように指定します。 この設定は db2support コマンドのデフォルトの動作ですが、 -fodc パラメーターには適用されません。

hostname

コマンド発行先ホスト (複数も可) を指定します。 このオプションを指定しない場合、コマンドはすべてのホストに対して発行されます。 複数のホストを指定する場合、すべてのホスト名が有効でないと、コマンドを完了できません。

Db2 pureScale® 環境でもパーティション・データベース環境でもない環境で -host オプションを指定すると、 db2support はエラーを返します。

-il | -isolation

データ・アクセス中にデータをロックして他のプロセスから分離する方法を決定するために使われる分離レベルを指定します。 デフォルトでは、CURRENT ISOLATION 特殊レジスターがブランクに設定されます。

-install

Db2 インストール・プロセスまたはインスタンス作成に関する問題のトラブルシューティングに必要な診断データを収集します。 診断データはdb2support.zipファイルに保存されます。 db2support.exe ファイルをローカル・システムにコピーします。これにより、 db2support コマンドを発行したときに、 db2support.exe をコピーした先のディレクトリーに db2support.zip ファイルが配置されます。 診断データを最も完全に収集するには、root 権限を使用してコマンドを発行してください。 また、-installパラメーターを使用してoutput_path変数を指定することにより、db2support.zipファイルの出力パスを指定したほうがいいと思います。

-host hostname | -host hostname_list

診断データ収集の対象ホストを指定します。 リモート・ホストのデータ収集の場合は、SSH 接続が必要です。 ホスト名を指定しない場合、ローカル・ホストの診断データが収集されます。

複数のホストで診断データを収集するには、-host パラメーターの後にhostname_listを指定してください。ここで、hostname_listリスト は、診断データを収集するホストのコンマ区切りリストです。

-instance instancename

診断データを収集するインスタンス名を指定します。 このパラメーターを指定しない場合、デフォルトでは、DB2INSTANCE 環境変数の定義インスタンスに関する診断データが収集されます。 特定のインスタンスに関する診断データを収集するには、-instanceパラメーターの後にインスタンス名を指定してください。ここで、インスタンス名 は、診断データを収集するインスタンスの名前です。

-l | -logs

アクティブ・ログをキャプチャーすることを指定します。

-localhost

コマンドが、ローカル・ホストに対して発行されるように指定します。 このオプションを指定しない場合、コマンドはすべてのホストに対して発行されます。

-m | -html

すべてのシステム出力が、HTML 形式のファイルにダンプされることを指定します。 デフォルトでは、すべてのシステム関連情報は、このパラメーターが使用されない場合は フラット・テキスト・ファイルにダンプされます。

-member member_number | member_range

コマンド発行先メンバー (複数も可) を指定します。 このパラメーターを指定しない場合、コマンドは現行メンバーに対して発行されます。 複数のメンバーを、member_number のコンマ区切りリスト (member1, member2) として、または member_range (member_range はメンバーの範囲 (member1-member3)) を使用して指定できます。最初の 2 つの方式を組み合わせて使用することもできます。

すべて

db2nodes.cfgに定義されるすべてのメンバーに対してコマンドを発行するように指定します。

db2support ツールは、ホストごとに実行します。 1 つのホストに複数のメンバーが存在する場合、db2support は対象のホストで一度だけ実行します。 コマンドを実行するメンバーを指定すると、db2support を実行するホストを判別するためだけにその指定のメンバー番号が使用されます。

Db2 pureScale 環境でもパーティション・データベース環境でもない環境で -member オプションを指定すると、 db2support はエラーを戻します。

-n | -number

現在の問題の問題管理レポート (PMR) 番号または ID を指定します。

-nc | -nocatalog

カタログ情報が収集されないことを指定します。 デフォルトでは、カタログ情報は収集されます。

-nl | -nodb2look

db2look コマンド情報が収集されないことを指定します。 デフォルトでは、db2look コマンド情報は収集されます。

-o ファイル名

db2support コマンドの発行後に生成される圧縮ファイルの名前を指定します。 絶対パスか相対パスを指定できます。 このパラメーターを指定する前に、パスが存在してアクセス可能になっていなければなりません。そうでないと、エラーが発生します。

このパラメーターを指定しない場合、圧縮ファイルの名前はdb2support.zipになります。

このパラメーターをoutput_pathパラメーターと一緒に使うと、output_path パラメーターに指定したパスは無視され、-oパラメーター指定パスが使われます。

-ol levels | -optlevel レベル

使用する最適化レベル特殊レジスターの値を指定します。 デフォルトは、dft_queryopt データベース構成パラメーターの値です。 最適化レベルの値を単一値またはコンマで区切った複数の値として指定できます。

複数の値を指定した場合、最初の値ですべての最適化情報が収集されます。 それぞれの追加の最適化レベルの値を指定した場合、Explain プランは、各レベルの収集の開始および終了時刻に従って、別個のファイルに収集され、保管されます。

-op | -optprofile

使用する最適化プロファイル特殊レジスターの値を指定します。 ステートメントのバインド時に有効な最適化プロファイルが存在した場合に限って、この値が必要です。 デフォルトは、 (空ストリング) です。

-ot | -opttables

CURRENT MAINTAINED TABLE TYPES FOR OPTIMIZATION 特殊レジスターの値を指定します。 この値は、動的 SQL 照会の処理を最適化する際に考慮できる表のタイプを示します。 この特殊レジスターの初期値は SYSTEM です。

-p password |-password パスワード

ユーザー ID のパスワードを指定します。

-ps | -purescale

追加の Db2 診断データ、およびクラスター・ファイル・システム、クラスター・マネージャー、uDAPL の追加の診断データを収集するように指定します。 このパラメーターは追加の診断データのみを収集しますが、これにはスペースが大量に消費されたり時間がかかったりします。 このパラメーターを指定することは、-cm、-cfs、-udaplパラメーターを指定することと同じです。

-pf filename | -profile ファイル名

代替プロファイル・ファイルを指定します。 このファイルの絶対パスを指定する必要があります。

デフォルト・プロファイルはdb2support.profileファイルで、このファイルのデフォルト・ディレクトリーはsqllib/admディレクトリーです。 Windows オペレーティング・システムでは、sqllib/adm ディレクトリーが存在しない場合は、これを作成してから db2support コマンドを発行する必要があります。

このプロファイル・ファイルを使用して、標準の db2support コマンド実行には組み込まれない情報を収集します。 このプロファイル・ファイルのテンプレートとして、以下のようなものを使用できます。 テンプレート 1 とテンプレート 2 をいくつでも任意に組み合わせて使用できます。

テンプレート 1

<COLLECTION>
<NAME>...</NAME>
<CMD>...</CMD>
<OUTFILE>...</OUTFILE>
<TIMEOUT>...</TIMEOUT>
</COLLECTION>

テンプレート 2

<COLLECTION>
<NAME>...</NAME>
<FILE>...</FILE>
<OUTFILE>...</OUTFILE>
<TIMEOUT>...</TIMEOUT>
</COLLECTION>

それぞれの収集項目は、名前、コマンド名またはファイル名、出力ファイル名、タイムアウト値で記述されます。 この情報は、追加情報を収集するために使用されます。

名前

収集されるデータの名前。

CMD

追加情報を収集するためにコマンド行で使用されるコマンド。 この値またはFILE値のいずれかを指定しなければなりません。両方を指定できません。

ファイル

収集するファイルの名前。 この値またはCMD値のいずれかを指定しなければなりません。両方を指定できません。

OUTFILE

収集される情報が格納される出力ファイルの名前。 これは必須の値です。

TIMEOUT

コマンド行の実行で許可される最長時間 (秒単位)。 デフォルト値は 180 秒です。

db2support コマンドは、ファイルを構文解析する際にすべてのブランク行をスキップします。

OUTFILEとCMDまたはFILEのいずれかの値が欠落した場合、コマンドがファイルを解析するときに、解析エラーは発生します。 このエラーが発生すると、db2support コマンドはこの収集をスキップします。 プロファイル・ファイルが解析された後、収集情報はUSERCOLLECTION/OUTFILEディレクトリーのdb2supp_system.zipファイルに保存されます。

-preupgrade

インスタンスのアップグレードや次のフィックスパックへの更新などの、重要なアップグレードまたは更新の前に、環境データと構成データを収集します。 このパラメーターは、アップグレードや更新後に生じる場合がある問題のトラブルシューティングに役立ちます。 このパラメーターは、-d、-o、-fodcpath、-nl、-member、-host パラメーターと組合せてから使用できます。

データ収集が完了すると、結果はdb2support_preupgrade.zipと呼ばれるファイルに圧縮されます。

-q | -question_response

対話式問題分析モードを使用することを指定します。

-ra | -refreshage

リフレッシュ経過時間特殊レジスターの値を指定します。 ステートメント内の表を参照するマテリアライズ照会表 (MQT) が存在する場合にのみ、この値が該当します。 CURRENT REFRESH AGE のデフォルト値はゼロです。

-r | -redistribute

データ再配分に関連する診断データをキャプチャーするように指定します。

-ro | -reopt

照会の EXPLAIN 時に、REOPT ONCE オプションを指定して EXPLAIN を使用するように指定します。 デフォルトでは、REOPT ONCE オプションを無視します。

-s | -system_detail

ハードウェアおよびオペレーティング・システムの詳細情報を収集することを指定します。

-se 組み込み SQL ファイル | -sqlembed 組み込み SQL ファイル

データ収集に関連した SQL ステートメントが入っている組み込み SQL ファイルのパスを指定します。

-sdir 共有ディレクトリー・パス | -S 共有ディレクトリー・パス

db2support コマンドがデータを収集している間に一時ストレージとして使用される共有ディレクトリーを指定します。 このパラメーターを指定しないと、データを一時的に格納するためにデフォルトの共有ディレクトリーが使用されます。 デフォルトの共有ディレクトリーは、 Db2 pureScale 環境では db2_instance_shared_directory/sqllib_shared 、パーティション・データベース環境では path/sqllib です。 一時的に格納されたデータは、db2support コマンドの実行が完了すると削除されます。

重要: sqllib_shared ディレクトリーは Db2 pureScale 環境のデフォルト共有ディレクトリーとして使用されるため、 db2support コマンドが収集するデータを保管するのに十分なスペースが sqllib_shared ディレクトリーにあることを確認してください。 sqllib_shared ディレクトリーに必要な最小ディスク・スペースを計算するには、以下の公式を使用できます。

10 GB + number of member/CF host x 2 GB

-sf SQL ファイル | -sqlfile SQL ファイル

データ収集に関連した SQL ステートメントが入っているファイル・パスを指定します。

Db2 pureScale およびパーティション・データベース環境では、絶対ファイル・パスを指定し、SQL ファイルがすべてのホストからアクセス可能なディレクトリーに保管されていることを確認する必要があります。 しかし、これらの複数のホスト環境にあるオプティマイザー収集の場合、-localhost オプションを使用して、単一ホストのデータを収集することをお勧めします。 例えば、次のコマンドを実行して、単一ホストのデータを収集する可能性があります。

 db2support -d <database_name> -sf <filepath> -localhost

ここで filepath は、SQL ファイルの絶対パスです。 上記の例で示されているように、-localhost オプションを使用する場合、ファイルが現行ディレクトリーに保管されていれば、絶対パスの代わりにファイル名を使用できます。

-st SQL ステートメント | -sqlstmt SQL ステートメント

データ収集に関連した SQL ステートメントを指定します。

-su user_name | -system_user user_name

データが収集されるシステム・ユーザーの名前を指定します。

-t time_interval | 時刻 time_interval

データ収集を特定の時間間隔に制限します。 時間間隔は、開始時刻、終了時刻、またはその両方を、コロンで区切ったタイム・スタンプ形式で指定できます。 タイム・スタンプの形式は、 YYYY 年-MM-DD とは-HH.Mm.SS.NNN です。

ここで、

YYYY

年を指定します。

MM

月 (01 から 12 まで) を指定します。

DD

日 (01 から 31 まで) を指定します。

hh

時間 (00 から 23 まで) を指定します。

mm

分 (00 から 59 まで) を指定します。

ss

秒 (00 から 59 まで) を指定します。

nnnnnn

UNIX オペレーティング・システムの場合はマイクロ秒、Windows オペレーティング・システムの場合はミリ秒を指定します。

年フィールドに続くフィールドの一部またはすべてを省略できます。 省略されたフィールドには、デフォルト値が使用されます。 月および日のデフォルト値は 1 で、他のすべてのフィールドのデフォルト値は 0 です。

開始時刻のみを指定した場合 (例えば、 -t 2012)、 db2support コマンドは、開始時刻より後に変更されたファイルを収集します。 終了時刻のみを指定した場合 (-t :2012 など)、db2support コマンドは、その終了時刻より前に変更されたファイルを収集します。 両方の時刻を指定した場合 (-t 2012:2013 など)、db2support コマンドは、その開始時刻と終了時刻の間に変更されたファイルを収集します。 このパラメーターにデフォルト値はありません。 少なくとも 1 つのタイム・スタンプを指定する必要があります。

このパラメーターは、-history パラメーターまたは-Hパラメーターと一緒に使用できません。

-Hパラメーターまたは-tパラメーターが指定されない場合、デフォルト値は14 日です。

-tbspname table_space_name

db2caem コマンドがアクティビティー・イベント・モニターを作成する表スペース名を指定します。 パーティション・データベース環境では、対象となる SQL ステートメントを実行するすべてのデータベース・パーティションにこの表スペースが存在しなければなりません。 オプションが指定されない場合、アクティビティー・イベント・モニターを作成する際に db2caem コマンドはデフォルトの表スペースを使用します。

-td | -delimiter

ステートメントの終了文字を指定します。 このコマンド・パラメーターは、 db2 コマンドの -td パラメーターと同じように機能します。 デフォルトのステートメント終了文字はセミコロンです。

-timeout N

db2support ツールが実行を停止するまでのタイムアウト期間を秒単位で指定します。 N 変数は、秒単位で指定する必要があります。 timeoutは特定の各コレクションのタイムアウトではなく、実行の開始からの合計実行時間を指定します。 期限切れが発生すると、db2support.zipファイルが作成され、エラー・メッセージが画面とdb2support.logファイルに書き込まれます。

このパラメーターは、他のどのパラメーターとも一緒に使用できます。

-u userid | -user ユーザー ID

データベースへの接続に使用するユーザー ID を指定します。

-udapl

uDAPL の診断データが、生成される.zipファイルにパッケージされることを指定します。 このパラメーターは、スペースが大量に消費されるか収集に時間がかかる追加の uDAPL データのみを収集します。

-unzip compressed_file_name

指定した圧縮ファイルから内容を抽出します。 このファイルへの絶対パスか相対パスを指定する必要があります。 また、 db2support -unzip コマンドは、ファイルの拡張子が .ZIP または .zip の場合にのみ、 compressed_file_name パラメーターに指定されたファイル名を認識します。

このパラメーターは、抽出ユーティリティーが使用できないシステム・ファイルのdb2support.zipファイルを抽出できます。

-unzip パラメーターを、他の db2support コマンド・モードのパラメーターと組み合わせることはできません。

output_path パラメーターと-unzipパラメーターを一緒に指定すると、抽出ファイルはoutput_path ディレクトリーに配置されます。 output_pathパラメーターを -unzipパラメーターで指定しない場合、compressed_file_nameと呼ばれる新しいディレクトリーが現在のディレクトリーに作成され、抽出さファイルはcompressed_file_nameディレクトリーに配置されます。

リスト

これを指定すると、圧縮ファイルの内容は標準出力にリストされますが、抽出されません。 ファイル名、サイズ、および日付が表示されます。 このパラメーターは、db2support.zipファイルが大きく、システムに使用できるスペースが少ない場合に役立ちます。

quiet

db2support コマンドにおいて、抽出したファイルが output_path ディレクトリー (output_path が発行されなかった場合には現行ディレクトリー) に既にある場合、入力を求めるプロンプトを出さないようにします。 quietパラメーターを指定しないと、指定ファイルを上書きするかどうかを確認するメッセージが表示されます。 このパラメーターを指定すると、プロンプトを出さずに既存のすべてのファイルが上書きされます。

-v | -verbose

このツールの実行中に、冗長出力を使用することを指定します。

-wlm

Db2 ワークロード・マネージャーの問題に関連する追加データが収集されるように指定します。 データは、収集レベル 0 (-cl 0) 以上でオプティマイザー・モードの一部として収集されます。

-x | -xml_generate

対話式問題分析モード (-q モード) に使われるデシジョン・ツリー・ロジック全体を含む XML 文書を生成することを指定します。

使用上の注意

db2support コマンドは、 -st、 -sf、または -se パラメーターを指定した場合にのみ、不正な照会関連情報を収集します。 最適化中にエラーまたはトラップが発生した場合は、 -cl 0 (コレクション・レベル・ゼロ) パラメーターを使用して、不正な照会を Explain することなく、すべてのカタログ表および db2look 表定義を収集します。 オプティマイザー収集の一部としてアクティビティー・イベント・モニター関連情報を収集するために、-aemパラメーター（ -stまたは-sfパラメーターを使用）またはイベント・モニター・オプションを指定できます。 オプティマイザーの問題を処理するには、これらのオプションのいずれか 1 つを指定する必要があります。

オプティマイザー収集のいずれかのオプションを指定する場合、-dパラメーターも指定しなければなりません。

-Fまたは-fullパラメーターを指定しない場合、オプティマイザー収集のために、過去3日間のdb2diag.logファイルのみが収集されます。 オプティマイザーコレクションの完全なdb2diag.logファイルを含む、diagpathのすべてのファイルを収集する場合、-Fまたは-fullパラメーターを指定しなければなりません。

ステートメント実行時に特殊レジスターをデフォルト値以外の値に設定する場合は、正しい問題分析に役立つように、これらの値を db2support コマンドに渡してください。 特殊レジスター・オプションは、db2caem コマンドの収集では無視されます。

-globalパラメーターは廃止されました。 -host all パラメーターが db2support コマンドのデフォルト動作であるため、すべてのホストからの情報がデフォルトで収集されます。

db2support コマンドは、デフォルトで Db2 pureScale コンポーネントに固有のほとんどの診断データを収集するため、実行に長時間かかります。 パラメーター -purescale、-cm、-cfs、または -udapl を指定すると、db2support コマンドは、スペースの使用量が多いか収集に時間がかかる追加の診断データを収集します。 ただし、この情報は、 Db2 pureScale 環境での問題判別プロセスの迅速化に役立ちます。

ビジネス・データのセキュリティーを保護するために、このコマンドは、表データ、スキーマ (DDL ステートメント)、ログを収集しません。 パラメーターによっては、アーカイブ・ログなど、スキーマとデータのいくつかの性質を組み込むことができるものもあります。 データベース・スキーマやデータを公開するパラメーターは、ご使用の際に注意してください。このコマンドを発行すると、機密データを扱う方法を示すメッセージが表示されます。

db2support コマンドは、このコマンドを実行するマシンからデータを収集します。 クライアント/サーバー環境では、データベース関連の情報は、インスタンス接続またはデータベース接続を経由して、 データベースがあるマシンから得られます。 例えば、オペレーティング・システムやハードウェアの情報 (-s パラメーター)、および診断ディレクトリー (diagpath および alt_diagpath) からのファイルは、db2support コマンドを実行するローカル・マシンから得られます。 バッファー・プール情報、データベース構成情報、表スペース情報などのデータは、データベースが物理的に存在するマシンから得られます。

db2support コマンドで受け入れられる照会のタイプの制限は以下のとおりです。

• 複数の照会はサポートされません。 複数の照会を 1 つのファイル内に入れた場合、このコマンドは照会ごとに必要なオブジェクトをすべて集めます。 しかし、EXPLAIN されるのは最後の照会だけです。 この状態は、組み込み静的 SQL ステートメントを含むファイルにも当てはまります。
• コマンドはカスタマー・アプリケーションを実行しません。 しかし、特定の不適切な照会や遅い照会を評価するために 3 つの方法のいずれかを使用している場合、db2support コマンドの実行と同時にアプリケーションを実行できます。
• ストアード・プロシージャーはサポートされません。

db2support コマンドは、動的 SQL の EXPLAIN データを収集しません。

FODC パッケージがデフォルトの診断パスとは異なるディレクトリー・パスに保管されている場合、または FODCPATH 設定で指定されたパスに含まれていない場合は、 -fodcpath パラメーターを使用して db2support コマンドに FODC パスを指定する必要があります。 その後、FODC パッケージがdb2support.zipファイルに組み込まれます。