pm_get_data_wp, pm_get_tdata_wp, pm_get_Tdata_wp, pm_get_data_lcpu_wp, pm_get_tdata_lcpu_wp et pm_get_Tdata_lcpu_wp Sous-routines
Objectif
Renvoie les données du moniteur de performances pour une partition de charge de travailspécifiée.
Bibliothèque
Bibliothèque d'API Performance Monitor (libpmapi.a)
Syntaxe
#include <pmapi.h>
int pm_get_data_wp (wp_handle, *pmdata)
pm_wp_handle_t wp_handle;
pm_data_t *pmdata;
int pm_get_tdata_wp (wp_handle, *pmdata, *time)
pm_wp_handle_t wp_handle;
pm_data_t *pmdata;
timebasestruct_t *time;
int pm_get_Tdata_wp (wp_handle, pmdata, * times)
pm_wp_handle_t wp_handle;
pm_data_t *pmdata;
pm_accu_time_t *times;
int pm_get_data_lcpu_wp (wp_handle, lcpuid, *pmdata)
pm_wp_handle_t wp_handle;
int lcpuid;
pm_data_t *pmdata;
int pm_get_tdata_lcpu_wp (wp_handle, lcpuid, *pmdata, *time)
pm_wp_handle_t wp_handle;
int lcpuid;
pm_data_t *pmdata;
timebasestruct_t *time;
int pm_get_Tdata_lcpu_wp (wp_handle, lcpuid, *pmdata, *times)
pm_wp_handle_t wp_handle;
int lcpuid;
pm_data_t *pmdata;
pm_accu_time_t *timesDescriptif
Ces sous-routines renvoient des données uniquement pour les activités des processus appartenant à une partition de charge de travail (WPAR) spécifiée.
Le descripteur WPAR spécifié représente un nombre opaque qui identifie de manière unique une WPAR. La sous-routine pm_get_wplist extrait ce descripteur WPAR .
| Sous-routines | Informations |
|---|---|
| pm_get_data_wp | Données du moniteur de performances en cours pour la WPAR spécifiée |
| pm_get_tdata_wp |
|
| pm_get_Tdata_wp |
|
| pm_get_data_lcpu_wp |
|
| pm_get_tdata_lcpu_wp |
|
| pm_get_Tdata_lcpu_wp |
|
Les sous-routines pm_get_data_lcpu_wp, pm_get_tdata_lcpu_wpet pm_get_Tdata_lcpu_wp extraient les données du moniteur de performances en cours pour la WPAR et le processeur logique spécifiés. L'ID processeur spécifié représente une valeur comprise entre 0 et le nombre maximal défini par le système (avec le paramètre _system_configuration.max_ncpus ). L'ID processeur représente toujours le même processeur, même après des opérations de reconfiguration dynamique. Si la WPAR ou le numéro de processeur logique spécifié n'a jamais été exécuté pendant l'intervalle de comptage, les sous-routines pm_get_data_lcpu_wp, pm_get_tdata_lcpu_wpet pm_get_Tdata_lcpu_wp peuvent renvoyer une erreur.
Les données du moniteur de performances sont toujours un ensemble de valeurs 64 bits, un ensemble par compteur de matériel sur les machines utilisées.
Paramètres
| Article | Descriptif |
|---|---|
| lcpuid | Identificateur du processeur logique. Chaque identificateur conserve un lien vers un processeur particulier entre les réamorçages, même après la reconfiguration dynamique. Cette valeur doit être comprise entre 0 et la valeur du paramètre _system_configuartion.max_ncpus . |
| donnéesPm | Pointeur vers une structure contenant les données de l'Analyseur de performances renvoyées. |
| time | Pointeur vers une structure contenant la valeur timebase lors de la dernière lecture des compteurs de surveillance des performances du matériel. Ce paramètre peut être converti en heure à l'aide de la sous-routine time_base_to_time . |
| times | Pointeur vers une structure contenant le temps cumulé (base de temps, temps PURR et temps SPURR) que les événements ont compté. Chaque compteur de temps peut être converti en temps à l'aide de la sous-routine time_base_to_time . |
| descripteur de script (wp_handle) | Descripteur opaque qui identifie de manière unique une WPAR. Ce descripteur peut être extrait à partir du nom de la WPAR à l'aide de la sous-routine pm_get_wplist . |
Valeurs renvoyées
| Article | Descriptif |
|---|---|
| 0 % | L'opération a abouti. |
| Code d'erreur positif | Exécutez la sous-routine pm_error pour décoder le code d'erreur. |
Codes d'erreur
Exécutez la sous-routine pm_error pour décoder le code d'erreur.
Fichiers
| Article | Descriptif |
|---|---|
| /usr/include/pmapi.h | Définit des macros standard, des types de données et des sous-routines. |