このトピックでは、トレースおよびデバッグ機能に関連する環境変数の一覧を示します。
- CCITRACE
- CCI トレースを有効にするときは、CCITRACE 環境変数を次のように設定して、トレースする情報の程度を指定します。
構文
CCITRACE=filename [options]
パラメーター
- filename トレース内容の出力先ログ ファイルの名前を指定します。このパラメーターを指定しない場合は、現在のディレクトリに ccitrace.log というログ ファイルが作成され、すべての options がデフォルト値に設定されます。
- options 次のいずれかまたはすべてを指定します。
| /F または -F |
CCI API 呼び出しの詳細をトレース ファイルにログ記録します。デフォルトは、filename または他のトレース オプションが指定されていない場合は OFF、指定されている場合は常に ON です。 |
| /P または -P |
プロトコル レベル呼び出しの詳細をトレース ファイルにログ記録します。デフォルトは OFF です。このフラグが OFF の場合は、CCI ユーザー レベル API の詳細のみトレースされます。このフラグが ON の場合は、関数トレーシングのレベルが大きく向上する可能性があります。 |
| /D または -D |
CCI 関数との間で渡されたすべてのバッファーの内容をログに記録します。デフォルトは OFF です。セキュリティ上の理由でデータ トレーシングを禁止するようにアプリケーションがコード化されている場合は、データ トレーシングが許可されない可能性があります。 |
したがって、CCI API 関数の流れおよび基礎となるプロトコル関数の流れをトレースするが、これらの呼び出しに渡されるユーザー データはトレースしない、デフォルト名が ccitrc1.trc の CCI トレース ファイル (一致する ccitrc1.idx ファイルを持つ) を作成するには、CCITRACE 環境変数の値を /P にします。
トレース オプションは、CCI.INI ファイルを使用して制御することもできますが、CCITRACE 環境変数で指定された値が優先されます。
- CODEWATCH_SRCPATH
- CodeWatch の呼び出し時に指定されたディレクトリ内で何も見つからなかった場合に使用するデバッガー用のソース ファイルの場所
- 値
- 検索ディレクトリのリスト (各項目はセミコロンで区切られます)。
- CODEWATCH_STBPATH
- CodeWatch の呼び出し時に指定されたディレクトリ内で何も見つからなかった場合に使用するデバッガー用の STB ファイルの場所。
- 値
- 検索ディレクトリのリスト (各項目はセミコロンで区切られます)。
- DBG_MVSPSKEL
- デバッグ用のスケルトン JCL
- ES_DDBG_PORT_RANGE
- ダイナミック デバッグに使用するポートの範囲。
- ポート番号をハイフンまたはカンマで区切って範囲を指定します。ポート番号が小さい方から大きい方の順に指定する必要があります。
- 構文
- 値
- デフォルト
- この値が設定されていない場合、ダイナミック デバッグではランダム ポートを使用します。
-
例
ES_DDBG_PORT_RANGE=8001-8040
- MFTRACE_ANNOTATIONS
- トレース ファイルの場所。
- MFTRACE_CONFIG
- CTF 構成ファイルの場所。
- MFTRACE_LOGS
- CTF ログ ファイルの場所。
- MFTSO_DEBUG
- デバッグ メッセージの表示を制御します。
- TX_MQTRACE
- WebSphere MQ 呼び出しの dfh0mqis でトレースを有効にします。