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

NAME

6       pmiPutValueHandle - add a value for a metric-instance pair via a handle
7

C SYNOPSIS

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

Perl SYNOPSIS

17       use PCP::LogImport;
18
19       pmiPutValueHandle($handle, $value);
20

DESCRIPTION

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

DIAGNOSTICS

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

SEE ALSO

40       LOGIMPORT(3),  pmiErrStr(3),  pmiGetHandle(3), pmiPutResult(3), pmiPut‐
41       Value(3), pmiPutText(3), pmiPutLabel(3) and pmiWrite(3).
42
43
44
45Performance Co-Pilot                                      PMIPUTVALUEHANDLE(3)