pm_start_mythread and pm_tstart_mythread Subroutine

Purpose

Starts Performance Monitor counting for the calling thread.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>

int pm_start_mythread()

int pm_tstart_mythread(*time)
timebasestruct_t *time;

Description

The pm_start_mythread subroutine starts Performance Monitor counting for the calling kernel thread. Counting is effective immediately unless the thread is in a group, and that group's counting is not currently set to On. The counting state of a thread in a group is obtained by ANDing the thread counting state with the group state.

The pm_tstart_mythread subroutine starts Performance Monitor counting for the calling kernel thread, and returns a timestamp indicating when the counting was started.

Parameters

Item Description
*time Pointer to a structure containing the timebase value when the counting was started. This can be converted to time using the time_base_to_time subroutine.

Return Values

Item Description
0 Operation completed successfully.
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

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