PMSTORE(1)                  General Commands Manual                 PMSTORE(1)

<?><?><?> (NAME)
       pmstore - <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pmstore [-fFLV?] [-D debug] [-h host] [-i instances] [-K spec] [-n
       pmnsfile] metricname value

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?> pmstore <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> metricname <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> -i <?><?><?><?><?> <?><?><?> <?><?><?>.
       instances <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?>/<?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> (whitespace) <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> metricname
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>.

       <?><?> <?><?><?><?> <?><?><?><?><?> pmstore <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (PMNS) <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> PMNS(5)<?> <?><?> <?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?> -n <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> pmnsfile
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> -h <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> pmstore
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (PMCD) <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> -L <?><?><?><?> <?><?><?><?><?><?> pmstore <?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> PMDA<?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> PMCD
       <?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?>.  <?><?><?><?><?><?><?><?><?> -h <?> -L
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?> -f <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> value <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> metricname<?> <?><?>
       <?><?><?> <?><?><?> <?><?><?>:

       1.  <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> integer
           (<?><?><?> <?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?> value
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           "0x" <?> <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
           (<?><?><?><?><?><?><?><?><?><?>) <?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?> "0X" <?><?><?> <?><?> <?><?><?> "0x"
           <?><?><?><?> <?><?><?><?> <?><?><?>.  <?><?><?><?><?><?> strtol(3)
           <?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       2.  <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> floating point
           (<?><?><?><?> <?><?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?>
           value <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>.  <?><?><?><?><?><?>
           strtod(3).

       3.  <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> string
           (<?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?> value <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> ASCII <?><?><?><?><?>
           <?><?><?><?><?><?>.

       4.  <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?> PM_TYPE_EVENT <?><?>
           PM_TYPE_AGGREGATE)<?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> value <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?>
           <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?> pmstore <?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> -L
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> -K
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> PMDA<?><?><?>
       DSO <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>.  <?><?><?><?><?><?><?> spec
       <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?>
       pmSpecLocalPMDA(3) <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?> -K
       <?><?><?><?><?><?><?> <?><?><?>.

       <?><?> <?><?><?><?> <?><?><?><?><?> pmstore <?><?><?><?><?>
       <?><?><?><?><?> (<?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> pmFetch(3) <?><?><?><?><?><?><?>
       <?><?><?>) <?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?> -F <?><?><?><?><?> <?><?>
       pmFetch(3) <?><?><?><?> <?><?> <?><?> <?><?> pmStore(3) <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> metricname <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?> value
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>).

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:

       -f, --force
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?>
            <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?>.

       -F, --fetch
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
            <?><?><?><?><?> <?><?>.

       -i insts, --insts=insts
            <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?>.

       -h host, --host=host
            <?><?><?><?><?> <?><?> pmcd(1) <?><?><?> host<?> <?><?> <?><?><?>
            localhost <?><?><?><?><?><?><?>.

       -K spec, --spec-local=spec
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
            <?><?> <?><?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?> -L)<?>
            <?><?><?><?><?><?> -K <?><?><?><?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?> PMDA<?><?><?> DSO <?><?> <?><?><?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?>.  <?><?><?><?><?><?><?> spec <?><?> <?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
            pmSpecLocalPMDA(3) <?><?><?><?><?><?> <?><?><?><?>.
            <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
            -K <?><?> <?><?><?> <?><?><?>.

       -L, --local-PMDA
            <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
            <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?> PMDA<?><?><?> DSO <?><?><?>
            <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
            PMCD.  <?><?><?><?><?><?> <?><?><?><?><?><?> -K.

       -n pmnsfile, --namespace=pmnsfile
            <?><?> <?><?><?><?> <?><?><?><?><?> pmcd <?><?><?><?> <?><?><?>
            <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
            (PMNS) <?><?> <?><?> $PCP_VAR_DIR/pmns/root
            <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?>
            <?><?><?><?><?><?> -n <?><?><?><?> <?><?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
            pmnsfile <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       -V, --version
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>.

       -?, --help
            <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

<?><?><?><?><?> (DIAGNOSTICS)
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       metricname <?> value <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       The value "???" is out of range for the data type (PM_TYPE_...)

       The value "???" is incompatible with the data type (PM_TYPE_...)

<?><?><?><?> PCP (PCP ENVIRONMENT)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> PCP_
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> PCP <?><?> <?><?><?>
       <?><?><?><?><?><?><?>.  <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       /etc/pcp.conf <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?> $PCP_CONF
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> pcp.conf(5)
       <?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (DEBUGGING
       OPTIONS)
       <?><?><?><?><?><?> -D <?><?> --debug <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> stderr
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?> <?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?>.  debug <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> pmdbg(1)
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> -l <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       pmcd(1), pminfo(1), pmval(1), PMAPI(3), pmFetch(3), pmSpecLocalPMDA(3),
       pmStore(3), strtod(3), strtol(3) <?> PMNS(5).

Performance Co-Pilot                  PCP                           PMSTORE(1)