Sets Performance Monitor programmation for a target thread.
Performance Monitor APIs Library (libpmapi.a)
int pm_set_program_thread ( pid, tid, *prog)
The pm_set_program_thread subroutine sets the Performance Monitor programmation for a target kernel thread. The thread must be stopped and must be part of a debuggee process, under the control of the calling process. The setting 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 lists returned by the pm_init subroutine.
The counting mode includes User Mode and/or Kernel Mode, and the Initial Counting State. The defaults are set to Off for User Mode and Kernel Mode, and the Initial Default State is set to delay counting until the pm_start_thread subroutine is called.
If the list includes an event which can be used with a threshold (as indicated by the pm_init subroutine), a threshold value can also be specified.
|pid||Process ID of target thread. Target process must be a debuggee of the caller process.|
|tid||Thread ID of target thread.|
|*prog||Specifies the event modes to use in Performance Monitor setup. The following modes are supported:|
|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_get_program_thread (pm_get_program_thread Subroutine) subroutine, pm_delete_program_thread (pm_delete_program_thread Subroutine) subroutine, pm_get_data_thread (pm_get_data_thread Subroutine) subroutine, pm_start_thread (pm_start_thread Subroutine) subroutine, pm_stop_thread (pm_stop_thread Subroutine) subroutine, pm_reset_data_thread (pm_reset_data_thread Subroutine) subroutine.
Performance Monitor API Programming Concepts in AIX 5L Version 5.1 General Programming Concepts.