Sets Performance Monitor programming for a specified workload partition (WPAR).
The pm_set_program_wp subroutine sets Performance Monitor programming for the processes that belong to the specified workload partition (WPAR). The programming includes the events to be counted, and a mode in which to count.
The events to count are in a list of event identifiers. The identifiers must be selected from the list that the pm_initialize subroutine (pm_initialize Subroutine) returns. If the list includes an event that can be used with a threshold, you can specify a threshold value.
In some platforms, you can specify an event group instead of individual events. Set the is_group bit field in the mode and type the group ID in the first element of the event array. The group ID can be obtained by the pm_initialize subroutine.
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. The default values for User mode and Kernel mode are Off. The initial default state is set to delay the counting until calling the pm_start subroutine (pm_start and pm_tstart Subroutine), and to count the activities of all of the processes running into the specified WPAR.
Item | Description |
---|---|
cid | Specifies the identifier of the WPAR for which the subroutine is to be set. The CID can be obtained from the WPAR name using the getcorralid system call. |
prog | Specifies the events and modes to use in Performance Monitor
setup. 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. |