PMIUSECONTEXT(3)

NAME
pmiUseContext - change LOGIMPORT context

C SYNOPSIS
#include <pcp/pmapi.h>
#include <pcp/import.h>

int pmiUseContext(int context);

cc ... -lpcp_import -lpcp

Perl SYNOPSIS
use PCP::LogImport;

pmiUseContext($context);

DESCRIPTION
As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiUseContext may be used by applications wishing to generate more than one PCP archive concurrently.

The context argument is a value returned from a previous call to pmStart(3) and on successful return from pmiUseContext, the current context will have been changed to the one identified by context.

DIAGNOSTICS
pmiUseContext returns zero on success else a negative value that can be turned into an error message by calling pmiErrStr(3).

SEE ALSO
LOGIMPORT(3), pmiErrStr(3) and pmiStart(3).