trace()

トレース・メッセージをログ宛先に書き込みます。

構文

void trace(String traceMsg)
 void trace(int traceLevel, String traceMsg)
 void trace(int traceLevel, int messageNum)
 void trace(int traceLevel, int messageNum, String param [,...])
 void trace(int traceLevel, int messageNum, Object[] paramArray)
 

パラメーター

traceLevel
出力するトレース・メッセージを決定するために使用されるトレース・レベル。このメソッドは、コラボレーション・オブジェクトのトレース・レベルがこの traceLevel 値以上の場合に、トレース・メッセージを書き込みます。このコラボレーションのトレース・レベルを定義し文書化して、管理者が使用するコラボレーション・オブジェクトのレベルを理解できるようにする必要があります。

traceMsg
トレース・ファイルに書き込まれるトレース・メッセージ・テキスト。

messageNum
コラボレーションのメッセージ・ファイル内のメッセージのメッセージ番号で、メッセージ番号で索引付けされます。メッセージ・テキスト・ファイルの設定方法の詳細は、メッセージ・ファイルの作成を参照してください。

param
単一メッセージ・パラメーターの値。コンマで区切られた、最大 5 つのメッセージ・パラメーターが可能です。各パラメーターは順次的に解決され、メッセージ・テキスト内のパラメーターになります。

paramArray
メッセージ・パラメーター値の配列。各パラメーターは順次的に解決され、メッセージ・テキスト内のパラメーターになります。

注記

trace() メソッドは、コラボレーション・ログ宛先にトレース・メッセージを送信します。

デフォルトのログ宛先は、ファイル InterchangeSystem.log です。

ユーザーは、InterChange Server 構成ファイル InterchangeSystem.cfg 内の LOG_FILE のパラメーター値を入力してログ宛先を変更することができます。

パラメーター値がファイル名あるいは STDOUT になることがあります。STDOUT は、InterChange Server のコマンド・ウィンドウにログを記録します。

トレース・ロギングに関連するシステム構成パラメーターを、さらに 3 つ設定することもできます。すべてのパラメーターは構成ファイル InterchangeSystem.cfg 内に格納されます。

trace() メソッドにはいくつかの形式があります。

コラボレーション・オブジェクトを構成して、システムまたはコラボレーションでトレースを生成することができます。コラボレーション生成トレースを出力するようにコラボレーションが構成されている場合、trace() メソッドは、コラボレーション・オブジェクトが出力するメッセージを生成します。トレースを使用する条件の決定についてのヘルプは、"トレース・メッセージの追加"を参照してください。

次の例では、メソッドの第 2 の形式を使用して、指定されたメッセージ・テキストでレベル 2 トレース・メッセージを生成します。

trace (2, "Starting to trace at Level 2");
 

次の例では、コラボレーション・オブジェクトのトレース・レベルが 2 以上の場合に、メソッドの第 4 の形式を使用して、コラボレーションのメッセージ・ファイル内にメッセージ 201 を書き込みます。メッセージには、名前と年の 2 つのパラメーターがあります。このメソッドの呼び出しは、これらのパラメーターの値を渡します。

trace(2, 201, "DAVID", "1961"); 
 

Copyright IBM Corp. 2004