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

Technical Reference: Base Operating System and Extensions, Volume 1

pm_get_data_mygroup or pm_get_tdata_mygroup Subroutine

Purpose

Returns Performance Monitor data for the counting group to which the calling thread belongs.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>

int pm_get_data_mygroup (*pmdata)
pm_data_t *pmdata;

int pm_get_tdata_mygroup (*pmdata, *time)
pm_data_t *pmdata;
timebasestruct_t *time;

Description

The pm_get_data_mygroup subroutine retrieves the current Performance Monitor data for the group to which the calling kernel thread belongs.

The pm_get_tdata_mygroup subroutine retrieves the current Performance Monitor data for the group to which the calling thread belongs, and a timestamp indicating the last time the hardware counters were read.

The Performance Monitor data is always a set (one per hardware counter on the machine used) of 64-bit values. The information returned also includes the characteristics of the group, such as the number of its members, if it is a process level group, and if its counters are consistent with the sum of the counters for all of the threads in the group.

Parameters

*pmdata Pointer to a structure to return the Performance Monitor data for the group to which the calling thread belongs.
*time Pointer to a structure containing the timebase value the last time the hardware Performance Monitoring counters were read. This can be converted to time using the time_base_to_time subroutine.

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_mygroup (pm_set_program_mygroup Subroutine) subroutine, pm_get_program_mygroup (pm_get_program_mygroup Subroutine) subroutine, pm_get_data_mygroup (pm_get_data_mygroup or pm_get_tdata_mygroup Subroutine) subroutine, pm_start_mygroup (pm_start_mygroup Subroutine) subroutine, pm_stop_mygroup (pm_stop_mygroup Subroutine) subroutine, pm_reset_data_mygroup (pm_reset_data_mygroup Subroutine) subroutine.

read_real_time or time_base_to_time Subroutine in AIX 5L Version 5.2 Technical Reference: Base Operating System and Extensions Volume 2.

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 ]