Starts Performance Monitor counting for the counting group to which a target thread belongs.
Performance Monitor APIs Library (libpmapi.a)
#include <pmapi.h>
int pm_start_group ( pid, tid)
pid_t pid;
tid_t tid;
The pm_start_group subroutine starts the Performance Monitor counting for a target kernel thread and the counting group to which it belongs. This counting is effective immediately for the target thread. For all the other thread members of the counting group, the counting will start after their next redispatch, but only if their current counting state is already set to On. The counting state of a thread in a group is obtained by ANDing the thread counting state with the group state. If their counting state is currently set to Off, no counting starts until they call either the pm_start_mythread subroutine or the pm_start_mygroup themselves, or until a debugger process calls the pm_start_thread subroutine or the pm_start_group subroutine on their behalf.
| pid | Process ID of target thread. Target process must be a debuggee of the caller process. |
| tid | Thread ID of target thread. |
| 0 | Operation completed successfully. |
| 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_get_program_group (pm_get_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_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.