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.

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.

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).