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).