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/impl.h>
11       #include <pcp/import.h>
12
13       int pmiPutValueHandle(int handle, const char *value);
14
15       cc ... -lpcp_import -lpcp
16

Perl SYNOPSIS

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

DESCRIPTION

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

DIAGNOSTICS

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

SEE ALSO

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