NAME
     pmtime - Performance Co-Pilot time control server

SYNOPSIS
     $PCP_BINADM_DIR/pmtime [-a] [-h] -p portname

DESCRIPTION
     pmtime provides a graphical user interface for PCP applications requiring
     time control.  pmtime is not normally invoked directly by users.  Rather,
     it is run by calling the Performance Metrics Application Programming
     Interface (PMAPI) function pmTimeConnect(3).

     The -p argument is required.  When pmtime starts, it creates portname in
     the file system.  This is a Unix domain socket serving as the control
     port that pmtime will accept new connections on.

     When starting, pmtime creates and initializes a ViewKit dialog containing
     controls that are suitable for live/real-time time control (if the -h
     flag is given) or for archive replay (if the -a flag is given).  If
     neither -h or -a are given, the default is -h.  The dialog will be
     initially managed (visible) only if the client requested it, as described
     in pmTimeConnect(3).

     pmtime will then enter its main loop, accepting new connections and
     sending time control IPC messages to its client(s).  These messages are
     described in detail in pmtime(3).

     When the number of connected clients reaches zero, pmtime will remove the
     control socket and exit.  Clients disconnect either by calling
     pmTimeDisconnect(3) or simply exiting (implicitly closing the socket
     connection).

     The arguments to pmtime are as follows:

     -a   Use archive mode.  This instructs pmtime to create a dialog with
          time controls suitable for manipulating the archive position,
          allowing full VCR control.  This argument is mutually exclusive with
          -h.

     -h   Use live (host) mode.  This instructs pmtime to create a dialog with
          time controls suitable for live/real-time monitoring.  This argument
          is mutually exclusive with -a.

     -p   Specifies the path to the control port, as described above.  If
          portname already exists, pmtime will display an error message and
          exit.  When pmtime exits, it removes portname.

PCP ENVIRONMENT
     Environment variables with the prefix PCP_ are used to parameterize the
     file and directory names used by PCP.  On each installation, the file
     /etc/pcp.conf contains the local values for these variables.  The
     $PCP_CONF variable may be used to specify an alternative configuration
     file, as described in pcp.conf(4).







                                                                             1





PMTIME(1)                                                            PMTIME(1)


SEE ALSO
     PMAPI(3) and pmtime(3).


                                                                        Page 2