エラー処理とロギング

コネクターは、現在実行中のビジネス・オブジェクトおよび動詞の処理に失敗する条件が発生した場合には、必ずエラー・メッセージを記録します。また、そのようなエラーが発生した場合、コネクターは、処理に失敗したビジネス・オブジェクトが、受信時点でどのような状態であったかを示すテキスト表現も出力します。出力されたテキストは、コネクターの構成に応じて、コネクターのログ・ファイルまたは標準出力ストリームに書き込まれます。このテキストは、エラーの原因を判別するための補助情報として使用できます。

エラー・タイプ

表 18 では、コネクターが各トレース・レベルで出力するトレース・メッセージのタイプについて説明します。これらのメッセージは、Java コネクター実行ラッパーなどの IBM WebSphere Business Integration Server Express アダプター・アーキテクチャーによるトレース・メッセージ出力に追加されます。

表 18. コネクター・トレース・メッセージ
トレース・レベル トレース・メッセージ
レベル 0 コネクターのバージョンを示すメッセージ。このレベルでは、その他のトレースは行われません。これはデフォルト値です。
レベル 1
  • 状況メッセージ。
  • 処理されたビジネス・オブジェクトごとの識別 (キー) 情報を示すメッセージ。
  • pollForEvents メソッドが実行されるたびにデリバリーされるメッセージ。

レベル 2
  • コネクターがビジネス・オブジェクトの処理中に検出または検索した情報 (配列や子ビジネス・オブジェクトなど) を含む、ビジネス・オブジェクト・ハンドラー・メッセージ。
  • ビジネス・オブジェクトが gotApplEvent() または executeCollaboration() のいずれかから統合ブローカーに通知されるたびにログに記録されるメッセージ。
  • ビジネス・オブジェクトが統合ブローカーからの要求として受信されたことを示すメッセージ。
レベル 3
  • コネクターがビジネス・オブジェクトの外部キーをいつ検出または設定したかなどの情報を含む、外部キー処理メッセージ。
  • ビジネス・オブジェクトの処理についての情報を示すメッセージ。例えば、このメッセージは、コネクターがビジネス・オブジェクト間で一致を検出した場合や、子ビジネス・オブジェクトの配列の中にビジネス・オブジェクトを検出した場合にデリバリーされます。

レベル 4
  • アプリケーション固有情報に関するメッセージ (ビジネス・オブジェクトのアプリケーション固有情報フィールドを解析する関数によって戻された値を示すメッセージなど)。
  • コネクターによる関数の開始または終了のタイミングを示すメッセージ。このメッセージは、コネクターの処理フローのトレースに役立ちます。
  • スレッドに固有のメッセージのすべて。コネクターによって複数のスレッドが作成される場合は、新しいスレッドが作成されるたびにメッセージが出力されます。

レベル 5
  • コネクターの初期化を示すメッセージ (統合ブローカーから検索された、各構成プロパティーの値を示すメッセージなど)。
  • アプリケーションで実行されたステートメントを含むメッセージ。このトレース・レベルでは、宛先アプリケーションで実行されたステートメントのすべてと、置換された変数の値がコネクターのログ・ファイルに含まれます。
  • コネクターでビジネス・オブジェクトの処理が開始される以前のビジネス・オブジェクトの表現 (コネクターがビジネス・オブジェクトを受信したときのビジネス・オブジェクトの状態を示すもの)、および、ビジネス・オブジェクトの処理を終了した後のビジネス・オブジェクトの表現 (コネクターからビジネス・オブジェクトを戻したときのビジネス・オブジェクトの状態を示すもの) を含むメッセージ。
  • ビジネス・オブジェクト・ダンプを含むメッセージ。
  • コネクターが実行時に作成したスレッドのそれぞれの状況を示すメッセージ。

エラー・メッセージ

コネクター・メッセージ・ファイル

コネクターが生成するすべてのエラー・メッセージは、JDBCConnector.txt または JDBCConnector_II_TT.txt というメッセージ・ファイルに保管されます (ll の部分には言語、TT の部分には国または地域を示す文字が入ります)。それぞれのエラー・メッセージの前にはエラー番号が付けられています。以下に例を示します。

20017
 Connector Infrastructure version does not match.
 

20018
 Connection from {1} to the Application is lost! Please enter 'q' 
 to stop the connector, then restart it after the problem is fixed.
 

20019
 Error: ev_id is NULL in pollForEvent().
 

Copyright IBM Corp. 2004