NAME

       pcp.env - script to set Performance Co-Pilot run-time environment variables

SYNOPSIS

       /etc/pcp.env

DESCRIPTION

       The  pcp.env script is sourced by assorted Performance Co-Pilot (PCP) scripts and utilities to define the
       PCP operating environment variables.  The conjugate for executable programs using the  PCP  libraries  is
       the __pmGetConfig(3) function.

       Typical usage of pcp.env in a script is as follows :

                #! /bin/sh

                # source the PCP environment variables
                . /etc/pcp.env
                rest of script ...

       The  full syntax and semantics of the pcp.conf file and the __pmGetConfig function are described in their
       respective reference pages.

       If the file $HOME/.pcp/pcp.conf exists then this will be processed after the system-wide  pcp.conf  file.
       This  provides  a  mechanism  to  selectively modify or augment the environment settings for PCP scripts,
       which maybe useful if the scripts are run with sudo(1) which cleans the environment of important settings
       that are required to ensure the correct execution of the PCP scripts, e.g.  $PATH or $PERL5LIB.

ENVIRONMENT

       The PCP_CONF environment variable specifies an alternative path to the pcp.conf file.

SEE ALSO

       PCPIntro(1), sudo(1), PCPIntro(3), PMAPI(3), __pmGetConfig(3) and pcp.conf(5).