pm_set_program_wp_mm Subroutine

Online bearbeiten

Zweck

Legt die Performance Monitor-Programmierung im Zählermultiplexmodus für eine angegebene Workloadpartitionfest.

Syntax

#include <pmapi.h>

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

Beschreibung

Die Subroutine pm_set_program_wp_mm legt die Performance Monitor-Programmierung im Zählermultiplexmodus für die Prozesse fest, die zu einer angegebenen Workloadpartition (WPAR) gehören. Die Programmierung enthält die Liste der zu zählenden Ereignisarrays und den zugehörigen Modus, in dem die einzelnen Ereignisarrays gezählt werden sollen. Für jedes Ereignisarray wird ein Zählmodus definiert. Die IDs müssen aus den Listen ausgewählt werden, die von der Subroutine pm_initialize zurückgegeben wird. Wenn die Liste ein Ereignis enthält, das mit einem Schwellenwert verwendet werden kann, können Sie einen Schwellenwert angeben.

Auf einigen Plattformen können Sie anstelle einzelner Ereignisse eine Ereignisgruppe angeben. Legen Sie das Bitfeld is_group im Modus fest und geben Sie die Gruppen-ID im ersten Element jedes Ereignisarrays ein. Die Gruppen-ID kann von der Subroutine pm_initialize abgerufen werden.

Der Zählmodus umfasst den Benutzermodus und/oder den Kernelmodus, den Anfangszählungsstatus und den Prozessbaummodus. Die Standardwerte für den Benutzermodus und den Kernelmodus sind Off. Der ursprüngliche Standardstatus wird festgelegt, um die Zählung bis zum Aufruf der Subroutine pm_start (Subroutine pm_start und pm_tstart) zu verzögern und die Aktivitäten aller Prozesse zu zählen, die in der angegebenen WPARausgeführt werden.

Wenn Sie die Subroutine pm_set_program_wp_mm für eine Multimoduszählung verwenden, behalten der Process Tree-Modus (PM_PROCTREE) und der Start Counting-Modus (PM_COUNT) die Werte bei, die in der ersten Programmiergruppe definiert sind.

Wenn der Prozessbaummodus auf den Status On gesetzt ist, gilt die Zählung nur für den aufrufenden Prozess und seine untergeordneten Prozesse.

Parameter

Element Beschreibung
CID Gibt die ID der WPAR an, für die die Programmierung festgelegt werden soll Die CID kann mit dem Systemaufruf getcorralid aus dem Namen der WPAR abgerufen werden.
programm_mm Gibt die Ereignisse und zugehörigen Modi an, die in der Performance Monitor-Konfiguration verwendet werden. Die folgenden Modi werden unterstützt:
PM-BENUTZER
Zählt Prozesse, die im Benutzermodus ausgeführt werden. Der Standardwert ist Off.
PM_KERNEL
Zählt Prozesse, die im Kernelmodus aktiv sind. Der Standardwert ist Off.
PM_XX_ENCODE_CASE_ONE anzahl
Startet die Zählung sofort. Der Standardwert ist Not to start counting.
PM_PROZESSBAUM
Setzt die Zählung nur für den aufrufenden Prozess und seine untergeordneten Prozesse auf On . Der Standardwert ist Off.

Rückgabewerte

Element Beschreibung
0 Operation wurde erfolgreich beendet.
Positiver Fehlercode Führen Sie die Subroutine pm_error (pm_error Subroutine) zum Decodieren des Fehlercodes aus.

Fehlercodes

Informationen zum Decodieren des Fehlercodes finden Sie in der Unterroutine pm_error (pm_error Subroutine).

Dateien

Element Beschreibung
/usr/include/pmapi.h Definiert Standardmakros, Datentypen und Subroutinen.