Technical Reference: Base Operating System and Extensions, Volume 1

pm_get_data, pm_get_tdata, pm_get_data_cpu, and pm_get_tdata_cpu Subroutine

Purpose

Returns systemwide Performance Monitor data.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>

int pm_get_data ( *pmdata)
pm_data_t *pmdata;

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

int pm_get_data_cpu (cpuid, *pmdata)
int cpuid;
pm_data_t *pmdata;

int pm_get_tdata_cpu (cpuid, *pmdata, *time)
int cpuid;
pm_data_t *pmdata;
timebasestruct_t *time;

Description

The pm_get_data subroutine retrieves the current systemwide Performance Monitor data.

The pm_get_tdata subroutine retrieves the current systemwide Performance Monitor data, and a timestamp indicating the last time the hardware counters were read.

The pm_get_data_cpu subroutine retrieves the current Performance Monitor data for the specified processor.

The pm_get_tdata_cpu subroutine retrieves the current Performance Monitor data for the specified processor, 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 machines used) of 64-bit values.

Parameters

*pmdata	Pointer to a structure that contains the returned systemwide Performance Monitor data.
*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.
cpuid	Logical processor identifier.

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 (pm_set_program Subroutine) subroutine, pm_get_program (pm_get_program Subroutine) subroutine, pm_delete_program (pm_delete_program Subroutine) subroutine, pm_start (pm_start Subroutine) subroutine, pm_stop (pm_stop Subroutine) subroutine, pm_reset_data (pm_reset_data 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.