---
name: "pmiunits"
section: "3"
platform: "linux"
package: "libpcp3-dev"
version: "4.3.2+really4.3.1-0.1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/pmiID"
---

# pmiunits(3)

construct core metric data structures

Part of [pmiID(3)](/pmiID/3.md).

## 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)](/LOGIMPORT/3.md)), 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)](/pmiAddMetric/3.md) and [**pmiAddInstance**(3)](/pmiAddInstance/3.md).

Refer to [**pmLookupDesc**(3)](/pmLookupDesc/3.md) 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)](/LOGIMPORT/3.md), [**pmiAddMetric**(3)](/pmiAddMetric/3.md), [**pmiAddInstance**(3)](/pmiAddInstance/3.md) and [**pmLookupDesc**(3)](/pmLookupDesc/3.md).