jcmd(1)

Name
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プロセスに診断コマンド・リクエストが送信されます。

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コマンドの後にコマンド名を指定して呼び出せば表示されます。

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

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

関連項目

    o   jps(1)

jps(1)