NAMEpmtime - Performance Co-Pilot time control server
SYNOPSIS
$PCP_BINADM_DIR/pmtime [-a] [-h] -p portname
DESCRIPTIONpmtime 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).
Page 1
1
PMTIME(1)PMTIME(1)SEE ALSOPMAPI(3) and pmtime(3).
Page 2
