Retrieves the Performance Monitor settings for the counting group to which a target thread belongs.
Performance Monitor APIs Library (libpmapi.a)
#include <pmapi.h>
int pm_get_program_group ( pid, tid, *prog)
pid_t pid;
tid_t tid;
pm_prog_t *prog;
The pm_get_program_group subroutine retrieves the Performance Monitor settings for the counting group to which a target kernel thread belongs. The thread must be stopped and must be part of a debuggee process under the control of the calling process. 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 the 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.
| 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_group (pm_set_program_group Subroutine) subroutine, pm_delete_program_group (pm_delete_program_group Subroutine) subroutine, pm_get_data_group (pm_get_data_group and pm_get_tdata_group Subroutine) subroutine, pm_start_group (pm_start_group Subroutine) subroutine, pm_stop_group (pm_stop_group Subroutine) subroutine, pm_reset_data_group (pm_reset_data_group Subroutine) subroutine.
Performance Monitor API Programming Concepts in AIX 5L Version 5.2 Performance Tools Guide and Reference.