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

NAME

6       pmiPutValue - add a value for a metric-instance pair
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/impl.h>
11       #include <pcp/import.h>
12
13       int pmiPutValue(const char *name, const char *instance,
14               const char *value);
15
16       cc ... -lpcp_import -lpcp
17

Perl SYNOPSIS

19       use PCP::LogImport;
20
21       pmiPutValue($name, $instance, $value);
22

DESCRIPTION

24       As part of the Performance Co-Pilot Log Import API (see  LOGIMPORT(3)),
25       pmiPutValue adds a single value to the current output record for a giv‐
26       en metric and instance.
27
28       The metric's name should match one defined earlier in a call to pmiAdd‐
29       Metric(3).
30
31       For  singular  metrics (those defined with an instance domain of PM_IN‐
32       DOM_NULL), the instance should be NULL or an  empty  string,  otherwise
33       instance should match the name of an instance defined earlier in a call
34       to pmiAddInstance(3) for the metric's instance domain.
35
36       The value should be in a format consistent with the  metric's  type  as
37       defined in the call to pmiAddMetric(3).
38
39       No  data will be written until pmiWrite(3) is called, so multiple calls
40       to pmiPutValue or pmiPutValueHandle(3) are typically used to accumulate
41       data  values  for  several  metric-instance  pairs  before calling pmi‐
42       Write(3).
43

DIAGNOSTICS

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

SEE ALSO

49       LOGIMPORT(3),  pmiAddInstance(3), pmiAddMetric(3), pmiErrStr(3), pmiPu‐
50       tResult(3), pmiPutValueHandle(3) and pmiWrite(3).
51
52
53
54Performance Co-Pilot                                            PMIPUTVALUE(3)
Impressum