Retrieves the Performance Monitor settings for the counting group to which the calling thread belongs.
Performance Monitor APIs Library (libpmapi.a)
int pm_get_program_mygroup ( *prog)
The pm_get_program_mygroup subroutine retrieves the Performance Monitor settings for the counting group to which the calling kernel thread belongs. This includes mode information and the events being counted, which are in a list of event identifiers. The identifiers come from the lists returned by the pm_init subroutine.
The counting mode includes user mode and kernel mode, and the current counting state.
If the list includes an event which can be used with a threshold (as indicated by the pm_init subroutine), a threshold value is also returned.
|*prog||Returns which Performance Monitor events and modes are set.
Supported modes are:
|0||No errors occurred.|
|Positive error code||Refer to the pm_error (pm_error Subroutine) subroutine to decode the error code.|
Refer to the pm_error (pm_error Subroutine) subroutine.
|/usr/include/pmapi.h||Defines standard macros, data types, and subroutines.|
The pm_init (pm_init Subroutine) subroutine, pm_error (pm_error Subroutine) subroutine, pm_set_program_mygroup (pm_set_program_mygroup Subroutine) subroutine, pm_delete_program_mygroup (pm_delete_program_mygroup Subroutine) subroutine, pm_get_data_mygroup (pm_get_data_mygroup Subroutine) subroutine, pm_start_mygroup (pm_start_mygroup Subroutine) subroutine, pm_stop_mygroup (pm_stop_mygroup Subroutine) subroutine, pm_reset_data_mygroup (pm_reset_data_mygroup Subroutine) subroutine.
Performance Monitor API Programming Concepts in AIX 5L Version 5.1 General Programming Concepts.