pm_get_data_wp ， pm_get_tdata_wp ， pm_get_Tdata_wp ， pm_get_data_lcpu_wp ， pm_get_tdata_lcpu_wp 和 pm_get_Tdata_lcpu_wp 子例程
用途
返回指定 工作负载分区的性能监视器数据。
库
性能监视器 API 库 (libpmapi.a)
语法
#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 *times描述
这些子例程仅返回属于指定 工作负载分区 (WPAR) 的进程活动的数据。
指定的 WPAR 句柄表示唯一标识 WPAR的不透明数字。 pm_get_wplist 子例程检索此 WPAR 句柄。
下表显示了这些子例程检索的信息。
| 子例程 | 信息 |
|---|---|
| pm_get_data_wp | 指定 WPAR 的当前性能监视器数据 |
| pm_get_tdata_wp |
|
| pm_get_Tdata_wp |
|
| pm_get_data_lcpu_wp |
|
| pm_get_tdata_lcpu_wp |
|
| pm_get_Tdata_lcpu_wp |
|
pm_get_data_lcpu_wp， pm_get_tdata_lcpu_wp和 pm_get_Tdata_lcpu_wp 子例程检索指定 WPAR 和逻辑处理器的当前性能监视器数据。 指定的处理器标识表示从 0 到系统定义的最大数目 (使用 _system_configuration.max_ncpus 参数) 的值。 处理器标识始终表示相同的处理器，即使在动态重新配置操作之后也是如此。 如果在计数时间间隔内从未运行指定的 WPAR 或逻辑处理器号，那么 pm_get_data_lcpu_wp， pm_get_tdata_lcpu_wp和 pm_get_Tdata_lcpu_wp 子例程可能会返回错误。
性能监视器数据始终是一组 64 位值，在所使用的机器上，每个硬件计数器一组。
参数
| 项 | 描述 |
|---|---|
| lcpuid | 逻辑处理器标识。 每个标识都在重新引导之间维护到特定处理器的链接，即使在动态重新配置之后也是如此。 此值必须在从 0 到 _system_configuartion.max_ncpus 参数的值的范围内。 |
| pmdata | 指向包含返回的性能监视器数据的结构的指针。 |
| 时间 | 最近一次读取硬件性能监视计数器时，指向包含 timebase 值的结构的指针。 可以使用 time_base_to_time 子例程将此参数转换为时间。 |
| times | 指向结构的指针，该结构包含计算事件的累积时间 (timebase， PURR 时间和 SPURR 时间)。 每次计数器都可以使用 time_base_to_time 子例程转换为时间。 |
| wp_handle | 唯一标识 WPAR的不透明句柄。 可以使用 pm_get_wplist 子例程从 WPAR 名称中检索此句柄。 |
返回值
| 项 | 描述 |
|---|---|
| 重大安全事件数量 | 操作成功完成。 |
| 正错误代码 | 运行 pm_error 子例程以解码错误代码。 |
错误代码
运行 pm_error 子例程以解码错误代码。
文件
| 项 | 描述 |
|---|---|
| /usr/include/pmapi.h | 定义标准宏，数据类型和子例程。 |