プローブの適用

Probekit は、バイトコード・インスツルメンテーション (BCI) エンジンを使用して、プローブをクラス・ファイル、jar ファイル、 または Java プロジェクトのディレクトリー・ツリー全体に適用します。

次の手順に従って、BCI エンジン ProbeInstrumenter を、コマンド行から実行します。
  1. ご使用の CLASSPATH 環境変数に、 probekit.jar ファイルの絶対パスおよびファイル名を必ず含めてください。probekit.jar ファイルは、Eclipse plugins フォルダーの org.eclipse.hyades.probekit サブフォルダーにあります。
  2. ご使用の PATH 環境変数に、次のような、ご使用のプラットフォームに合った org.eclipse.hyades.probekit のサブフォルダーへの絶対パスを必ず含めてください。
    • os¥win32¥x86 (Windows)
    • os/solaris/sparc (Solaris)
    • os/linux/x86 (Linux)
    その他のプラットフォームでは、独自のサブディレクトリーがあります。
  3. コマンド・プロンプトで、コマンド java ProbeInstrumenter を入力し、その後に、使用する .probescript ファイルの名前、プローブ装備対象項目のリストを続けます。 リスト項目は、クラス・ファイル、jar ファイル、またはディレクトリーです。 以下に例を示します。
    java ProbeInstrumenter myprobe.probescript c:¥myproject_path¥myprogram.jar
BCI エンジンは、クラス・ファイルにプローブを装備するとき、そのクラス・ファイルの名前を *.class.bak に変更し、装備済みのコピーをその場所に入れます。 BCI エンジンは、jar ファイルにプローブを装備するとき、その jar ファイルの名前を *.jar.bak に変更し、その jar ファイルのコピー内部のすべてのクラス・ファイルを装備して、装備済みのコピーをその場所に入れます。 BCI エンジンは、フォルダーにプローブを装備するとき、ディレクトリー・ツリーを再帰的に下降して、クラス・ファイルおよび jar ファイルを前述のとおりに処理します。
注: BCI エンジンは、すでに Probekit で装備済みのクラス・ファイルおよび jar ファイルでは作動しません。 まず最初に、既存のプローブ・インスツルメンテーションを除去しなければなりません。

親トピック: プローブの作成および使用

前のトピック: プローブのコンパイル
次のトピック: プローブを使用してプロジェクトを実行

Copyright IBM Corporation and others 2000, 2004.