PMGETPMNSLOCATION(3)       Library Functions Manual       PMGETPMNSLOCATION(3)

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

Performance Co-Pilot                  PCP                 PMGETPMNSLOCATION(3)