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