NAME

pmGetPMNSLocation - determine the location of the currently used PMNS

C SYNOPSIS

#include <pcp/pmapi.h>

int pmGetPMNSLocation(void);

cc ... -lpcp

DESCRIPTION

If an application needs to know where the Performance Metrics Name Space (PMNS) is coming from then pmGetPMNSLocation will return whether it is from an archive, PMNS_ARCHIVE, or from a local PMNS file, PMNS_LOCAL, or from a remote pmcd, PMNS_REMOTE.

This information may be useful in determining an appropriate error message depending on the PMNS' location.

PCP ENVIRONMENT

Environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. On each installation, the file /etc/pcp.conf contains the local values for these variables. The $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5). Values for these variables may be obtained programmatically using the pmGetConfig(3) function.

SEE ALSO

PMAPI(3), pmGetConfig(3), pmLoadASCIINameSpace(3), pmLoadNameSpace(3), pmTrimNameSpace(3), pcp.conf(5), pcp.env(5) and pmns(5).

DIAGNOSTICS

PM_ERR_NOPMNS

If is not possible to determine where the location of the PMNS is. This could be due to problems with the current context or being unable to load a local PMNS.