1PMIPUTMARK(3)              Library Functions Manual              PMIPUTMARK(3)
2
3
4

NAME

6       pmiPutMark - write a <mark> record to a PCP archive
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/import.h>
11
12       int pmiPutMark(void);
13
14       cc ... -lpcp_import -lpcp
15

Perl SYNOPSIS

17       use PCP::LogImport;
18
19       pmiPutMark();
20

DESCRIPTION

22       As  part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)),
23       pmiPutMark writes a <mark> record to the current  PCP  output  archive.
24       This  is  required  when  there is a temporal discontinuity between the
25       current input source and the next input source, if any, and  should  be
26       called  after  the final call to pmiWrite(3) for the current input.  If
27       there is no next input to be  processed  or  no  temporal  gap  between
28       sources, then the <mark> record is not required.
29
30       The  <mark>  record is used to signify a temporal gap, so that when re‐
31       playing the output PCP archive, interpolation of metric  values  should
32       not be performed between the last timestamp in the current input source
33       to the first timestamp in the next input source, i.e. across the <mark>
34       record.
35

DIAGNOSTICS

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

SEE ALSO

41       LOGIMPORT(3), pmiAddInstance(3), pmiAddMetric(3), pmiErrStr(3),  pmiPu‐
42       tResult(3),    pmiPutValue(3),   pmiPutValueHandle(3),   pmiPutText(3),
43       pmiPutLabel(3) and pmiWrite(3).
44
45
46
47Performance Co-Pilot                                             PMIPUTMARK(3)