perfstat_memory_page_wpar Subroutine
Purpose
Retrieves use statistics for multiple page size for workload partitions (WPAR)
Library
Perfstat Library (libperfstat.a)
Syntax
#include <libperfstat.h>
int perfstat_memory_page_wpar ( name, psize, userbuff, sizeof_userbuff, desired_number )
perfstat_id_wpar_t *name;
perfstat_psize_t *psize;
perfstat_memory_total_wpar_t *userbuff;
int sizeof_userbuff;
int desired_number;Description
The perfstat_memory_page_wpar subroutine returns the page statistics for the WPAR in perfstat_memory_page_wpar_t structure.
To get the statistics of the particular page size, the name of the WPAR must be specified with the psize parameter, the userbuff parameter must be allocated, and the desired_number parameter must be set to the number of structures to be retrieved.
Parameters
| Item | Description |
|---|---|
| name | Specifies the name or ID of a WPAR to get the memory page statistics of the particular WPAR. If the memory page size statistics belongs to the calling process need to be retrieved, the value of this parameter is null. When the subroutine is called inside a WPAR, only the value of null can be specified. |
| psize | Specifies the page size for which the statistics are to be collected. |
| userbuff | Points to the memory area that is to be filled with the perfstat_memory_page_wpar_t structure. |
| sizeof_userbuff | Specifies the size of the perfstat_memory_page_wpar_t structure. |
| desired_number | Specifies the number of different page size statistics to be collected. |
Return Values
Upon successful completion, the number of structures filled is returned. The returned value is one.
If unsuccessful, a value of -1 is returned.
Error Codes
The perfstat_memory_page_wpar subroutine is unsuccessful if the following is true:
| Item | Description |
|---|---|
| EINVAL | One of the parameters is not valid |
Files
The libperfstat.h file defines standard macros, data types, and subroutines.