PMPOST(1)

NAME
pmpost - append messages to the Performance Co-Pilot notice board

SYNOPSIS
$PCP_BINADM_DIR/pmpost message

DESCRIPTION
pmpost will append the text message to the end of the Performance Co-Pilot (PCP) notice board file ($PCP_LOG_DIR/NOTICES) in an atomic manner that guards against corruption of the notice board file by concurrent invocations of pmpost.

The PCP notice board is intended to be a persistent store and clearing house for important messages relating to the operation of the PCP and the notification of performance alerts from pmie(1) when other notification options are either unavailable or unsuitable.

Before being written, messages are prefixed by the current time, and when the current day is different to the last time the notice board file was written, pmpost will prepend the message with the full date.

If the notice board file does not exist, pmpost will create it. pmpost would usually run from long-running PCP daemons executing under the (typically unprivileged) $PCP_USER and $PCP_GROUP accounts. The file should be owned by root, and group writable by the $PCP_GROUP group.

FILES

$PCP_LOG_DIR/NOTICES
    the PCP notice board file

PCP ENVIRONMENT
The file /etc/pcp.conf contains the local values for PCP_ variables.

UNIX SEE ALSO
logger(1).

WINDOWS SEE ALSO
pcp-eventlog(1).

SEE ALSO
pmie(1), pcp.conf(5) and pcp.env(5).