pm_start_wp and pm_tstart_wp Subroutines

Purpose

Starts Performance Monitor counting for a specified workload partition.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>

int pm_start_wp(cid)
cid_t cid;

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

Description

The pm_start_wp and pm_tstart_wp subroutines start counting for the activities of the processes that belong to a specified workload partition (WPAR).

The pm_start_wp subroutine starts Performance Monitor counting for a specified WPAR.

The pm_tstart_wp subroutine starts 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 that the counting starts from. 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.