pmwhichcontext(3) [centos man page]

PMWHICHCONTEXT(3)					     Library Functions Manual						 PMWHICHCONTEXT(3)

NAME

       pmWhichContext - identify the current PMAPI context

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmWhichContext(void);

       cc ... -lpcp

DESCRIPTION

       An  application	using  the  Performance Metrics Application Programming Interface (PMAPI) may manipulate several concurrent contexts, each
       associated with a source of performance metrics, e.g. pmcd(1) on some host, or an archive log of performance metrics as created	by  pmlog-
       ger(1).

       pmWhichContext  returns	a handle for the current PMAPI context, that may be used in the associated PMAPI routines that require a handle to
       identify a PMAPI context.

SEE ALSO

       PMAPI(3), pmDestroyContext(3), pmDupContext(3), pmNewContext(3) and pmUseContext(3).

DIAGNOSTICS

       PM_ERR_NOCONTEXT
	      no current context

Performance Co-Pilot							PCP							 PMWHICHCONTEXT(3)

PMDUPCONTEXT(3) 					     Library Functions Manual						   PMDUPCONTEXT(3)

NAME

       pmDupContext - duplicate a PMAPI context

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmDupContext(void);

       cc ... -lpcp

DESCRIPTION

       An  application	using  the  Performance Metrics Application Programming Interface (PMAPI) may manipulate several concurrent contexts, each
       associated with a source of performance metrics, e.g. pmcd(1) on some host, or an archive log of performance metrics as created	by  pmlog-
       ger(1).

       Calling	pmDupContext  will  replicate  the  current PMAPI context, returning a handle for the new context that may be used with subsequent
       calls to pmUseContext(3).

       Once created, the duplicated context and the original context have independent existence, and so their  instance  profiles  and	collection
       time (relevant only for archive contexts) may be independently varied.

       The newly replicated context becomes the current context.

SEE ALSO

       PMAPI(3), pmNewContext(3) and pmUseContext(3).

Performance Co-Pilot							PCP							   PMDUPCONTEXT(3)