IMS リソース・アダプターを使用したロギングおよびトレース

他の J2EE コンポーネントのほかに、IMS リソース・アダプターも、ロギングおよびトレース・コンポーネント情報に関するコントロールを提供します。これらのコントロールがロギングおよびトレース用に設定されている場合に、 WebSphere® 単体テスト環境を使用して Java™ アプリケーションを実行すると、トレース・ファイルが作成されます。

注 : トレースが有効な場合は、実行中のクライアントが 1 つのみであることを確認してください。

ロギングおよびトレース用にコントロールを設定するには、以下のステップを実行します。

  1. 「サーバー構成」ビューでご使用のサーバー構成をダブルクリックして、WebSphere サーバー構成エディターを開きます。
  2. エディターの「J2C」タブを選択します。
  3. J2C オプション」ページの「J2C リソース・アダプター」表で、IMS リソース・アダプターを選択します。
  4. J2C 接続ファクトリー」表までスクロールして、トレースをオンにする接続ファクトリーを選択します。
  5. リソース・プロパティー (Resource Properties)」表までスクロールして、TraceLevel リソース・プロパティーを選択します。 ロギングおよびトレースを使用可能にするには、ゼロ以外の値を指定します。 TraceLevel 値は、インターフェース com.ibm.connector2.ims.ico.IMSTraceLevelProperties の定数に対応しています。
    TraceLevel 値 IMSTraceLevelProperties 説明
    0 RAS_TRACE_OFF トレースまたはロギングは発生しません。
    1 RAS_TRACE_ERROR_EXCEPTION エラーおよび例外のみが記録されます。
    2 RAS_TRACE_ENTRY_EXIT エラーおよび例外に加えて、重要なメソッドの入り口と出口が記録されます。
    3 RAS_TRACE_INTERNAL エラーおよび例外、重要なメソッドの入り口と出口、および IMS Connect との間で送受信されるバッファーの内容が記録されます。
  6. J2C (J2C) タブのページに TraceLevel 値を入力したら、「トレース (Trace)」タブを選択します。
  7. トレースを使用可能にする (Enable trace)」チェック・ボックスが選択されていることを確認します。 IMS リソース・アダプターのロギングおよびトレースを使用可能にするには、 「ストリングのトレース (Trace string)」フィールドに以下のように入力します。
    com.ibm.connector2.ims.*=all=enabled
    com.ibm.ims.ico.*=all=enabled
    トレース・ストリングのその他の組み合わせを使用すると、別のコンポーネントでトレースが使用可能になります。例えば、以下のトレース・ストリングを使用するとします。
    com.ibm.ejs.j2c.*=all=enabled:com.ibm.connector2.*=all=enabled

    ストリング com.ibm.ejs.j2c.* は、WebSphere による J2EE Connector Architecture 実装のロギングおよびトレースを有効にし、ストリング com.ibm.connector2.* は、IMS™ を含むすべてのリソース・アダプターのロギングおよびトレースを有効にします。

  8. トレース出力ファイルのデフォルトの名前およびロケーションを受け入れたり、これらを変更することができます。 例えば、置換変数の設定方法に応じて、デフォルトの名前およびロケーションは以下のようになります。
    your_workspace¥.metadata¥.plugins¥com.ibm.etools.server.core
    ¥tmp0¥logs¥server1¥trace.log
    デフォルトの名前およびロケーションを変更するには、サーバー構成の 「トレース・オプション」ページの「トレース出力ファイル」フィールドに別のファイル名およびロケーションを入力します。
  9. 変更が終了したら、エディターを閉じ、「はい」を選択して、変更を保管します。
  10. サーバー」ビューの「状況」列を確認し、必要な場合、サーバー・インスタンスを再始動します。 WebSphere テスト環境を使用している場合は、通常、サーバー・インスタンスの再始動が必要となります。
  11. Java アプリケーションを実行してから、 トレース・ファイルを調べます。
関連資料
IMS リソース・アダプターを使用した場合の問題の診断
J2CA0056I、WLTC0017E、HWSP1445E、および HWSSL00E エラー・メッセージ
IMS リソース・アダプター・メッセージおよび例外
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.