pmctl コマンド

目的

パフォーマンス・モニター・イベントの生成を開始、リセット、または停止します。

構文

pmctl[ [-E[モード] ] ]。[-f interval] {[-y command]}}| [-h] | [-r] | [-S ] ] [ -s[-s] [ {-a -y コマンド[-f インターバル] } ]

説明

pmctl コマンドは、PMAPI サブシステムでパフォーマンス・モニター・イベントの生成を開始、リセット、または停止して、tprof -E コマンドを使用した人手によるオフライン・モードをサポートします。また、 PMAPI サブシステムの現在の状況もレポートします。

フラグ

項目	説明
-a	大規模ページ分析をオンにします。
-E (E) [ モード ]	イベント・ベースのプロファイル作成を可能にします。以下のいずれかのモードを指定できます。 PM_イベントプロファイルを作成するハードウェア・イベントを指定します。 -E フラグにモードを指定しない場合、デフォルトのイベントはプロセッサー・サイクル (PM_CYC) です。 EMULATION エミュレーション・プロファイル作成モードを使用可能にします。 ALIGNMENT 調整プロファイル作成モードを使用可能にします。 ISLBMISS 命令セグメント索引バッファー・ミス・プロファイル作成モードを使用可能にします。 DSLBMISS データ・セグメント索引バッファー・ミス・プロファイル作成モードを使用可能にします。
「-f」間隔	使用すべきサンプリング間隔を指定します。プロセッサー・サイクルの場合、EMULATION、 ALIGNMENT、ISLBMISS、および DSLBMISS の各イベントでは、1 から 500 ミリ秒を指定します (デフォルトは 10 ミリ秒)。パフォーマンス・モニター・イベントの場合、10000 から最大 MAXINT 発生数を指定します (デフォルトは 10000)。 -f フラグを -y フラグと一緒に使用すると、他のパフォーマンス・モニター・イベントの場合は 1 から最大 MAXINT 発生数まで指定します (デフォルトは 10000)。
-h	man ページ情報を表示します。
-r	PMAPI サブシステムの解放とリセットを行います。
-S	パフォーマンス・モニター・イベントの生成を停止します。
-s	PMAPI サブシステムの現在の状況を表示します。
-y コマンド	イベント・ベースのプロファイル作成をオンにするのは、指定コマンドとその子孫に限定されます。

セキュリティー

RBAC ユーザーおよび TrustedAIX®ユーザーの皆様へ：このコマンドは特権操作を実行できます。特権命令を実行できるのは特権ユーザーのみです。権限および特権について詳しくは、「セキュリティー」の『特権コマンド・データベース』を参照してください。このコマンドに関連した特権および権限のリストについては、lssecattr コマンドまたは getcmdattr サブコマンドの項を参照してください。

例

パフォーマンス・モニター・イベントの生成を停止するには、以下のコマンドを入力します。
```
pmctl –S
```
パフォーマンス・モニター・イベントの生成をリセットするには、以下のコマンドを入力します。
```
pmctl –r
```
PMAPI サブシステム内の現在の状況をレポートするには、以下のコマンドを入力します。
```
pmctl –s
```
パフォーマンス・モニター・イベントの生成を開始するには、以下のコマンドを入力します。
```
pmctl –E
```
指定の workload コマンドとその子孫に対してのみパフォーマンス・モニター・イベントの生成を開始するには、以下のコマンドを入力します。
```
pmctl –E –y workload
```
人手によるオフライン・モードで tprof -Eをサポートするには、以下のコマンドを入力します。
```
trace -adf -o mydata.trc
trcon
pmctl –E 
sleep 10; trcstop
gensyms > mydata.syms
tprof –suker mydata
```
指定の workload コマンドとその子孫に対してプロファイル作成するための人手によるオフライン・モード状態で、tprof -Eをサポートするには、以下のコマンドを入力します。
```
trace -adf -o mydata.trc
trcon
pmctl –E –y workload
trcstop
gensyms > mydata.syms
tprof –suker mydata 
```