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(4). Values for these variables may be
obtained programatically using the pmGetConfig(3) function.
SEE ALSO
PMAPI(3), pmGetConfig(3), pmLoadASCIINameSpace(3), pmLoadNameSpace(3),
pmTrimNameSpace(3), pcp.conf(4), pcp.env(4) and pmns(4).
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.