Retrieves system-wide Performance Monitor setting for a specified workload partition (WPAR).
Performance Monitor APIs Library (libpmapi.a).
The pm_get_program_wp subroutine retrieves system-wide Performance Monitor settings for the processes that belong to the specified workload partition (WPAR). These settings include the mode information and the events that are being counted.
The events being counted are in a list of event identifiers. The identifiers must be selected from the list that the pm_init subroutine (pm_init Subroutine) returns. If the list includes an event that can be used with a threshold, you can specify a threshold value.
If the events are represented by a group ID, then the is_group bit is set in the mode, and the first element of the events array contains the group ID. The other elements of the events array are not meaningful.
The counting mode includes both User mode and Kernel mode, or either of them; the Initial Counting state; and the Process Tree mode.
If the Process Tree mode is set to the On state, the counting only applies to the calling process and its descendants.
Item | Description |
---|---|
cid | Specifies the identifier of the WPAR for which the subroutine is to retrieve. The CID can be obtained from the WPAR name using the getcorralid system call. |
prog | Returns the Performance Monitor events and modes that are set.
The following modes are supported:
|
Item | Description |
---|---|
0 | Operation completed successfully. |
Positive error code | Run the pm_error subroutine (pm_error Subroutine) to decode the error code. |
To decode the error code, see the pm_error subroutine (pm_error Subroutine).
Item | Description |
---|---|
/usr/include/pmapi.h | Defines standard macros, data types, and subroutines. |