jcmd(1)

名前
jcmd - 診断コマンド

jcmdは、実行中のJava仮想マシンに診断コマンド・リクエストを送信するユーティリティです。

形式

    jcmd [ option ]
    jcmd <pid | main class> PerfCounter.print
    jcmd <pid | main class> command [arguments]
    jcmd <pid | main class> -f file

説明

jcmdは、この機能をサポートするJava仮想マシンに診断コマンド・リクエストを送信するユーティリティです。

引数なしまたは-lオプションを指定してjcmdを使用すると、実行中のJavaプロセスがプロセスID、メイン・クラスおよびコマンドライン引数とともに表示されます。

プロセスIDをコマンドラインに指定すると、jcmdでは、このIDのプロセスに診断コマンド・リクエストが送信されます。

メイン・クラスをコマンドラインに指定すると、jcmdでは、コマンドライン引数がJavaプロセスのメイン・クラスの部分文字列であるすべてのJavaプロセスに診断コマンド・リクエストが送信されます。

PerfCounter.print引数を指定すると、jcmdでは、ターゲットのJavaプロセスで使用可能なパフォーマンス・カウンタが出力されます。

-f オプションを指定すると、jcmdでは、fileに保存されている診断コマンドがターゲットのJavaプロセスに送信されます。

オプション

各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述してください。

    -l  実行中のJavaプロセスの一覧がプロセスID、メイン・クラスおよびコマンドライン引数とともに出力されます。

    -h  ヘルプ・メッセージが出力されます。

    -help
        ヘルプ・メッセージが出力されます。

パラメータ

    pid 診断コマンド・リクエストを受信するプロセスを指定します。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)またはjcmd(1)を使用します。

    main class
        診断コマンド・リクエストを受信するプロセスのメイン・クラスです。プロセスを照合する際には、指定された文字列がメイン・クラス名に部分文字列として含まれているすべてのプロセスが一致したとみなされます。いくつかの実行中のJavaプロセスがこのメイン・クラスを共有している場合は、それらすべてのプロセスに診断コマンド・リクエストが送信されます。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)またはjcmd(1)を使用します。

    command [arguments]
        commandという名前の診断コマンドをターゲットのJavaプロセスに対して起動します。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対してhelpコマンドを呼び出せば表示されます。各診断コマンドには独自のargumentsのセットがあり、コマンド名の後にhelpを指定して呼び出せば表示されます。

    PerfCounter.print
        ターゲットのJavaプロセスで使用可能なパフォーマンス・カウンタが出力されます。パフォーマンス・カウンタのリストはJavaプロセスによって異なる場合があります。

    -f file
        fileからコマンドを読み取って、ターゲットのJavaプロセスで呼び出します。fileでは、各コマンドを1行に記述する必要があります。#で始まる行は無視されます。すべての行が呼び出されるか、stopキーワードを含む行が読み取られると、fileの処理が終了します。

関連項目

    o   jps(1)

jps(1)