1PMIPUTVALUE(3) Library Functions Manual PMIPUTVALUE(3)
2
3
4
6 pmiPutValue - add a value for a metric-instance pair
7
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
19 use PCP::LogImport;
20
21 pmiPutValue($name, $instance, $value);
22
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
45 pmiPutValue returns zero on success else a negative value that can be
46 turned into an error message by calling pmiErrStr(3).
47
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)