NAME

       pmdaSendError - send an error PDU to PMCD

C SYNOPSIS

       #include <pcp/pmapi.h>
       #include <pcp/pmda.h>

       void pmdaSendError(pmdaInterface *dispatch, int err);

       cc ... -lpcp_pmda -lpcp

PYTHON SYNOPSIS

       from pcp.pmda import PMDA
       PMDA.pmda_notready()
       PMDA.pmda_ready()

DESCRIPTION

       As  part  of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), this routine allows a PMDA to
       send an error PDU to PMCD.  There is presently only one use for this - so the PMDA can inform  PMCD  that
       it is ready (or not ready) to process requests.

       The protocol details are described in pmcd(1) and PMDA(3), but basically if a PMDA starts in the notready
       state  (as  may be specified in pmcd.conf, see pmcd(1)) then PMCD will not send it any requests until the
       PMDA sends an PM_ERR_PMDAREADY error PDU using this function.  This is used by a PMDA  that  may  have  a
       long startup time, e.g. to process a large configuration file or similar.

SEE ALSO

       PMAPI(3), PMDA(3), pmcd(1), and pmdaopenmetrics(1).

Performance Co-Pilot                                   PCP                                      PMDASENDERROR(3)