Sets Performance Monitor programmation in counter multiplexing mode and multi-mode for the calling thread.
Performance Monitor APIs Library (libpmapi.a)
#include <pmapi.h>
int pm_set_program_mythread_mx ( *prog)
pm_prog_mx_t *prog;
int pm_set_program_mythread_mm ( *prog_mm)
pm_prog_mm_t *prog_mm;
The pm_set_program_mythread_mx and the pm_set_program_mythread_mm subroutines set the Performance Monitor programmation respectively in counter multiplexing mode or in multi-mode for the calling kernel thread.
The pm_set_program_mythread_mx subroutine setting includes the list of the event arrays to be counted, and a mode in which to count. The mode is global to all event lists. The events to count are in an array of list of event identifiers.
The pm_set_program_mythread_mm setting includes the lists of the event arrays to be counted, and the associated modes in which to count each event array. A counting mode is defined for each event array.
The event identifiers must be selected from the lists returned by the pm_initialize subroutine.
The counting mode for both subroutines includes the User Mode or the Kernel Mode, or both of them; 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_mythread subroutine is called.
When you use the pm_set_program_mythread_mm subroutine for multi-mode counting, the Process Tree Mode and the Start Counting Mode are fixed by the their values defined in the first programming set.
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.
Item | Description |
---|---|
*prog | Specifies
the events and the modes to use in the Performance
Monitor setup. The prog parameter supports
the following modes:
|
*prog_mm | Specifies the events and the modes to use in the Performance
Monitor setup. The prog_mm parameter supports
the following modes:
The PM_PROCTREE mode and the PM_COUNT mode defined in the first setting fix the value for the counting. |
Item | Description |
---|---|
0 | Operation completed successfully. |
Positive Error Code | Refer to the pm_error Subroutine to decode the error code. |
Refer to the pm_error Subroutine.
Item | Description |
---|---|
/usr/include/pmapi.h | Defines standard macros, data types, and subroutines. |