1PMIPUTVALUEHANDLE(3) Library Functions Manual PMIPUTVALUEHANDLE(3)
2
3
4
6 pmiPutValueHandle - add a value for a metric-instance pair via a handle
7
9 #include <pcp/pmapi.h>
10 #include <pcp/import.h>
11
12 int pmiPutValueHandle(int handle, const char *value);
13
14 cc ... -lpcp_import -lpcp
15
17 use PCP::LogImport;
18
19 pmiPutValueHandle($handle, $value);
20
22 As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)),
23 pmiPutValueHandle adds a single value to the current output record for
24 a given metric and instance, using the handle defined by an earlier
25 call to pmiGetHandle(3).
26
27 The value should be in a format consistent with the metric's type as
28 defined in the call to pmiAddMetric(3).
29
30 No data will be written until pmiWrite(3) is called, so multiple calls
31 to pmiPutValueHandle or pmiPutValue(3) are typically used to accumulate
32 data values for several metric-instance pairs before calling pmi‐
33 Write(3).
34
36 pmiPutValueHandle returns zero on success else a negative value that
37 can be turned into an error message by calling pmiErrStr(3).
38
40 LOGIMPORT(3), pmiErrStr(3), pmiGetHandle(3), pmiPutResult(3), pmiPut‐
41 Value(3) and pmiWrite(3).
42
43
44
45Performance Co-Pilot PMIPUTVALUEHANDLE(3)