pm_stop_wp and pm_tstop_wp Subroutines

Purpose

Stops Performance Monitor counting for a specified workload partition.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>

int pm_stop_wp (cid)
cid_t cid;

int pm_tstop_wp(cid, *time)
cid_t cid;
timebasestruct_t *time;

Description

The pm_stop_wp and pm_tstop_wp subroutines stop counting for the activities of the processes that belong to a specified workload partition (WPAR).

The pm_stop_wp subroutine stops Performance Monitor counting for a specified WPAR.

The pm_tstop_wp subroutine stops Performance Monitor counting for a specified WPAR, and returns a timestamp indicating when the counting was started.

Parameters

Item	Description
cid	Specifies the WPAR identifier from which the counting stops. The CID can be obtained from the WPAR name using the getcorralid system call.
time	Pointer to a structure that contains the timebase value when the counting starts. The value of time can be converted to time using the time_base_to_time subroutine.

Return Values

Item	Description
0	Operation completed successfully.
Positive error code	Run the pm_error subroutine (pm_error Subroutine) to decode the error code.

Error Codes

Run the pm_error subroutine to decode the error code.

Files

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