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

Technical Reference: Base Operating System and Extensions, Volume 1


pm_start_mygroup Subroutine

Purpose

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

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>
 
int_pm_start_mygroup()

Description

The pm_start_mygroup subroutine starts the Performance Monitor counting for the calling kernel thread and the counting group to which it belongs. Counting is effective immediately for the calling thread. For all the other threads members of the counting group, the counting starts after their next redispatch, but only if their current counting state is already set to On. The counting state of a thread in a group is obtained by ANDing the thread counting state with the group state. If their counting state is currently set to Off, no counting starts until they call either the pm_start_mythread subroutine or the pm_start_mygroup subroutine themselves, or until a debugger process calls the pm_start_thread subroutine or the pm_start_group subroutine on their behalf.

Return Values


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


/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_delete_program_mygroup (pm_delete_program_mygroup Subroutine) subroutine, pm_get_data_mygroup (pm_get_data_mygroup Subroutine) subroutine, pm_stop_mygroup (pm_stop_mygroup Subroutine) subroutine, pm_reset_data_mygroup (pm_reset_data_mygroup Subroutine) subroutine.


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