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

Technical Reference: Base Operating System and Extensions, Volume 1


pm_delete_program_group Subroutine

Purpose

Deletes previously established Performance Monitor settings for the counting group to which a target thread belongs.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax


#include <pmapi.h>


int pm_delete_program_group ( pid, tid)
pid_t pid;
tid_t tid;

Description

The pm_delete_program_group subroutine deletes previously established Performance Monitor settings for a target kernel thread. The thread must be stopped and must be part of a debuggee process under the control of the calling process. The settings for the group to which the target thread belongs and from all the other threads in the same group are also deleted.

Parameters


pid Process identifier of target thread. The target process must be a debuggee under the control of the calling process.
tid Thread identifier of a target thread.

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_group (pm_set_program_group Subroutine) subroutine, pm_get_program_group (pm_get_program_group Subroutine) subroutine, pm_get_data_group (pm_get_data_group Subroutine) subroutine, pm_start_group (pm_start_group Subroutine) subroutine, pm_stop_group (pm_stop_group Subroutine) subroutine, pm_reset_data_group (pm_reset_data_group Subroutine) subroutine.

Performance Monitor API Programming Concepts in AIX 5L Version 5.1 General Programming Concepts.


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