pm_set_program_wp_mm サブルーチン

目的

指定された ワークロード・パーティションに対して、カウンター多重方式でパフォーマンス・モニター・プログラミングを設定します。

構文

#include <pmapi.h>

int pm_set_program_wp_mm (cid, *prog_mm)
cid_t cid; 
pm_prog_mm_t *prog_mm;

説明

pm_set_program_wp_mm サブルーチンは、指定された ワークロード・パーティション (WPAR) に属するプロセスに対して、カウンター多重方式でパフォーマンス・モニター・プログラミングを設定します。 プログラミングには、カウントされるイベント配列のリスト、および各イベント配列をカウントする関連モードが含まれます。 イベント配列ごとにカウント・モードが定義されます。 ID は、 pm_initialize Subroutine サブルーチンが戻すリストから選択する必要があります。 しきい値で使用できるイベントがリストに含まれている場合は、しきい値を指定できます。

プラットフォームによっては、個々のイベントの代わりにイベント・グループを指定できます。 is_group ビット・フィールドをモードに設定し、各イベント配列の最初のエレメントにグループ ID を入力します。 グループ ID は、 pm_initialize サブルーチンによって取得できます。

カウント・モードには、ユーザー・モードとカーネル・モードの両方、またはそのいずれか、初期カウント状態、およびプロセス・ツリー・モードが含まれます。 ユーザー・モードとカーネル・モードのデフォルト値は Offです。 初期デフォルト状態は、 pm_start サブルーチン (pm_start および pm_tstart サブルーチン) を呼び出すまでカウントを遅らせ、指定された WPAR内で実行されているすべてのプロセスのアクティビティーをカウントするように設定されます。

マルチモード・カウントに pm_set_program_wp_mm サブルーチンを使用する場合、プロセス・ツリー・モード (PM_PROCTREE) および開始カウント・モード (PM_COUNT) は、最初のプログラミング・セットで定義された値を保持します。

プロセス・ツリー・モードが On 状態に設定されている場合、カウントは呼び出しプロセスとその子孫にのみ適用されます。

パラメーター

戻り値

エラー・コード

エラー・コードをデコードするには、 pm_error サブルーチン (pm_error サブルーチン) を参照してください。

ファイル