[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1

pm_get_program Subroutine


Retrieves systemwide Performance Monitor settings.


Performance Monitor APIs Library (libpmapi.a)


#include <pmapi.h>

int pm_get_program ( *prog)
pm_prog_t *prog;


The pm_get_program subroutine retrieves the current systemwide Performance Monitor settings. 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, the kernel mode, the current counting state, and the process tree mode. If the process tree mode is on, the counting applies only to the calling process and its decendants.

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:

Counting processes running in user mode

Counting processes running in kernel mode

Counting is on

Counting applies only to the calling process and its descendants

Return Values

0 No errors occurred.
Positive error code Refer to the pm_error (pm_error Subroutine) subroutine to decode the error code.

Error Codes

Refer to the pm_error (pm_error Subroutine) subroutine.


/usr/include/pmapi.h Defines standard macros, data types, and subroutines.

Related Information

pm_init (pm_init Subroutine), pm_error (pm_error Subroutine), pm_set_program (pm_set_program Subroutine), pm_delete_program (pm_delete_program Subroutine), pm_get_data (pm_get_data Subroutine), pm_start (pm_start Subroutine), pm_stop (pm_stop Subroutine), pm_reset_data (pm_reset_data Subroutine) subroutines.

Performance Monitor API Programming Concepts in AIX 5L Version 5.1 General Programming Concepts.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]