NAME
pmUseContext - change current PMAPI context
C SYNOPSIS
#include <pcp/pmapi.h>
int pmUseContext(int handle)
cc ... -lpcp
DESCRIPTION
An application using the Performance Metrics Application
Programming Interface (PMAPI) may manipulate several con
current contexts, each associated with a source of perfor
mance metrics, e.g. pmcd(1) on some host, or an archive
log of performance metrics as created by pmlogger(1).
Calling pmUseContext causes the current PMAPI context to
be set to the context identified by handle. The value of
handle must be one returned from an earlier call to pmNew
Context(3) or pmDupContext(3).
Below the PMAPI, all contexts used by an application are
saved in their most recently modified state, so pmUseCon
text restores the context to the state it was in the last
time the context was used, not the state of the context
when it was established.
SEE ALSO
PMAPI(3), pmDestroyContext(3), pmDupContext(3), pmNewCon
text(3) and pmWhichContext(3).
DIAGNOSTICS
PM_ERR_NOCONTEXT
handle does not identify a valid PMAPI context
Man(1) output converted with
man2html