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