centos man page for pmgetpmnslocation

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.

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 configura-
       tion 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.

Performance Co-Pilot							PCP						      PMGETPMNSLOCATION(3)