e(1)](../man1/pmtime.1.html) instance via the IPC channel identified by the
           _port_ argument.
    
           The **-S** , **-T** , **-O** and **-A** options may be used to define a time window
           to restrict the samples retrieved, set an initial origin within
           the time window, or specify a ``natural'' alignment of the sample
           times; refer to [PCPIntro(1)](../man1/PCPIntro.1.html) for a complete description of these
           options.
    

##  OPTIONS  top

    
    
           The available command line options are:
    
           **-a** _archive_ , **--archive** =_archive_
                Performance metric values are retrieved from the set of
                Performance Co-Pilot (PCP) archive files identified by the
                _archive_ argument, which is a comma-separated list of names,
                each of which may be the base name of an archive or the name
                of a directory containing one or more archives.
    
           **-A** _align_ , **--align** =_align_
                Force the initial sample to be aligned on the boundary of a
                natural time unit _align_.  Refer to [PCPIntro(1)](../man1/PCPIntro.1.html) for a
                complete description of the syntax for _align_.
    
           **-g** , **--guimode**
                Start **pmstat** as the client of a new [pmtime(1)](../man1/pmtime.1.html) server process
                for replay of archived performance data using the [pmtime(1)](../man1/pmtime.1.html)
                graphical user interface.
    
           **-h** _host_ , **--host** =_host_
                Fetch performance metrics from [pmcd(1)](../man1/pmcd.1.html) on _host_ , rather than
                from the default localhost.
    
           **-H** _path_ , **--hostsfile** =_path_
                Specify the _path_ to a file containing a set of hostnames
                where [pmcd(1)](../man1/pmcd.1.html) is running , rather than using the default
                localhost.
    
           **-K** _spec_ , **--spec-local** =_spec_
                When fetching metrics from a local context (see **-L**), the **-K**
                option may be used to control the DSO PMDAs that should be
                made accessible.  The _spec_ argument conforms to the syntax
                described in [pmSpecLocalPMDA(3)](../man3/pmSpecLocalPMDA.3.html).  More than one **-K** option
                may be used.
    
           **-l** , _--suffix_
                Prints the last 7 characters of a hostname in summaries
                involving more than one host (when more than one **-h** option
                has been specified on the command line).
    
           **-L** , **--local-PMDA**
                Use a local context to collect metrics from DSO PMDAs on the
                local host without PMCD.  See also **-K**.
    
           **-n** _pmnsfile_ , **--namespace** =_pmnsfile_
                Load an alternative Performance Metrics Name Space ([PMNS(5)](../man5/PMNS.5.html))
                from the file _pmnsfile_.
    
           **-O** _origin_ , **--origin** =_origin_
                When reporting archived metrics, start reporting at _origin_
                within the time window (see **-S** and **-T**).  Refer to
                [PCPIntro(1)](../man1/PCPIntro.1.html) for a complete description of the syntax for
                _origin_.
    
           **-p** _port_ , **--guiport** =_port_
                Attach **pmstat** to an existing [pmtime(1)](../man1/pmtime.1.html) time control process
                instance via the IPC channel identified by the _port_
                argument.  This option is normally only used by other tools,
                e.g.  [pmchart(1)](../man1/pmchart.1.html), when they launch **pmstat** with synchronized
                time control.
    
           **-P** , **--pause**
                Pause between updates for archive replay.
    
           **-s** _samples_ , **--samples*