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

Technical Reference: Base Operating System and Extensions, Volume 1

pm_get_program_mythread Subroutine

Purpose

Retrieves the Performance Monitor settings for the calling thread.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax


#include <pmapi.h>

int pm_get_program_mythread ( *prog)
pm_prog_t *prog;

Description

The pm_get_program_mythread subroutine retrieves the Performance Monitor settings for the calling kernel thread. 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 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.

Parameters

*prog Returns which Performance Monitor events and modes are set. Supported modes are:
PM_USER
Counting processes running in user mode
PM_KERNEL
Counting processes running in kernel mode
PM_COUNT
Counting is on

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.

Files

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

Related Information

The pm_init (pm_init Subroutine) subroutine, pm_error (pm_error Subroutine) subroutine, pm_set_program_mythread (pm_set_program_mythread Subroutine) subroutine, pm_delete_program_mythread (pm_delete_program_mythread Subroutine) subroutine, pm_get_data_mythread (pm_get_data_mythread or pm_get_tdata_mythread Subroutine) subroutine, pm_start_mythread (pm_start_mythread Subroutine) subroutine, pm_stop_mythread (pm_stop_mythread Subroutine) subroutine, pm_reset_data_mythread (pm_reset_data_mythread Subroutine) subroutine.

Performance Monitor API Programming Concepts in AIX 5L Version 5.2 Performance Tools Guide and Reference.

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