PMIUNITS(3)

NAME
pmiUnits, pmiID, pmiInDom - construct core metric data structures

C SYNOPSIS
#include <pcp/pmapi.h>
#include <pcp/import.h>

pmID pmiID(int domain, int cluster, int item);
pmInDom pmiInDom(int domain, int serial);
pmUnits pmiUnits(int dimSpace, int dimTime, int dimCount, int scaleSpace, int scaleTime, int scaleCount);

cc ... -lpcp_import -lpcp

Perl SYNOPSIS
use PCP::LogImport;

$pmid = pmiID($domain, $cluster, $item);
$indom = pmiInDom($domain, $serial);
$units = pmiUnits($dimSpace, $dimTime, $dimCount, $scaleSpace, $scaleTime, $scaleCount);

DESCRIPTION
As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), these routines provide convenience methods (especially for script use) for constructing pmID, pmInDom and pmUnits structures respectively, to be used in subsequent calls to pmiAddMetric(3) and pmiAddInstance(3).

Refer to pmLookupDesc(3) for a complete description of the values and semantics of the components of a pmUnits structure, and hence the valid argument values for pmiUnits.

DIAGNOSTICS
None.

SEE ALSO
LOGIMPORT(3), pmiAddMetric(3), pmiAddInstance(3) and pmLookupDesc(3).