NAME

       pmiWrite - flush data to a LOGIMPORT archive

C SYNOPSIS

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

       int pmiWrite(int sec, int usec);

       cc ... -lpcp_import -lpcp

Perl SYNOPSIS

       use PCP::LogImport;

       pmiWrite($sec, $usec);

DESCRIPTION

       As  part  of  the  Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiWrite forces
       accumulated data values out to the PCP archive.

       The data values and associated metadata have previously  been  built  up  using  calls  to
       pmiAddMetric(3), pmiAddInstance(3), pmiPutValue(3) and pmiPutValueHandle(3).

       The  current  set  of  data  values  and any new metadata is written to the archive with a
       timestamp of sec and usec in the source timezone of the archive, see pmiSetTimezone(3).

DIAGNOSTICS

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

SEE ALSO

       LOGIMPORT(3),    pmiAddInstance(3),    pmiAddMetric(3),    pmiErrStr(3),   pmiPutValue(3),
       pmiPutValueHandle(3), pmiPutText(3), pmiPutLabel(3) and pmiSetTimezone(3).