NAME

       pmGetPMNSLocation  -  determine  the  location of the cur­
       rently used PMNS


C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmGetPMNSLocation(void)

       cc ... -lpcp


DESCRIPTION

       If an application needs to know where the Performance Met­
       rics  Name Space (PMNS) is coming from then pmGetPMNSLoca­
       tion  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 appropri­
       ate 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), pmLoad­
       NameSpace(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.


Man(1) output converted with man2html