PMIWRITE(3)

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) and pmiSetTimezone(3).