NAME

       pmiErrStr - convert a LOGIMPORT error code into a string

C SYNOPSIS

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

       const char *pmiErrStr(int code);
       char *pmiErrStr_r(int code, char buf, int buflen);

       cc ... -lpcp_import -lpcp

Perl SYNOPSIS

       use PCP::LogImport;

       pmiErrStr($code);

DESCRIPTION

       As  part  of  the  Performance  Co-Pilot  Log  Import  API  (see  LOGIMPORT(3)), pmiErrStr
       translates error codes returned from the other routines in the  Log  Import  library  into
       printable error messages.

       code  would  normally  have  a  negative value.  As a special case, if code is -1 then the
       error code returned from the last routine called in the LOGIMPORT library for this context
       will be used.

       The  pmiErrStr_r  function  does the same, but stores the result in a user-supplied buffer
       buf of length buflen, which should have room for at least PMI_MAXERRMSGLEN bytes.

       The set of possible error codes and messages is  all  those  defined  by  pmErrStr(3)  and
       PCPIntro(3),  plus  the  additonal ones defined in <pcp/import.h> with error code names of
       the form PMI_ERR_....

DIAGNOSTICS

       None.

SEE ALSO

       LOGIMPORT(3), PCPIntro(3) and pmErrStr(3).