compiles a Performance Metrics Name Space (PMNS) in ASCII format into a more
efficient binary representation.
is able to load this binary representation significantly faster than the
equivalent ASCII representation.
will exit without overwriting it.
By convention, the name of the compiled namespace is that of the root file of
the ASCII namespace, with
appended. For example, the root of the default PMNS is a file named
and the compiled version of the entire namespace is
The options are;
By default the PMNS to be compiled is expected to contain at most one
name for each unique Performance Metric Id (PMID). The
option relaxes this restriction and allows the compilation of a
PMNS in which multiple names may be associated with a single PMID.
Duplicate names are useful when a particular metric may
be logically associated with more than one group of related metrics,
or when it is desired to create abbreviated aliases to name a set
of frequently used metrics.
Force overwriting of an existing
if it already exists.
operates on the default PMNS, however if the
option is specified an alternative namespace is loaded
from the file
writes a version
compiled namespace, which is compatible with
versions of PCP before PCP2.0.
will write a version
namespace which is compatible with PCP2.0 or later.
Note that PCP version 2.0 or later can handle both versions
but PCP versions prior to PCP 2.0 can only handle version
The default input PMNS is found in the file
unless the environment variable
is set, in which case the value is assumed to be the pathname
to the file containing the default input PMNS.
Once the writing of the new
has begun, the signals SIGINT, SIGHUP and SIGTERM will be ignored
to protect the integrity of the new file.
default PMNS specification files
compiled version of the default PMNS, when the environment variable
some standard macros for PMID generation
Environment variables with the prefix
are used to parameterize the file and directory names
used by PCP.
On each installation, the file
contains the local values for these variables.
variable may be used to specify an alternative
as described in