poestat
 
 
  NAME
 
  poestat - Starts the System Status Array, which is an X-Windows tool
  for monitoring the operational status and CPU utilization of processor
  nodes.
 
 
  SYNOPSIS
 
  poestat [-norm]
 
  The poestat command starts the System Status Array.  This X-Windows
  tool lets you quickly survey the utilization of processor nodes.
  Normally, this would be run in the background.
 
 
  FLAGS
 
  -norm          Indicates that the SP system Resource Manager, which
                 would normally be used to select nodes for monitoring,
                 is not available.  Instead, the System Status Array
                 program selects for monitoring each of the nodes on the
                 LAN that have the VT Statistics Collector Daemon (digd)
                 running.  It also selects each of the nodes listed in
                 the host list file indicated by the MP_HOSTFILE
                 environment variable.  If you are monitoring nodes of
                 an RS/6000 network cluster, you must use this flag.
 
 
  DESCRIPTION
 
  The poestat command starts the System Status Array.  This X-Windows
  monitoring tool lets you quickly survey the utilization of processor
  nodes.  The Array consists of a number of squares, each representing a
  processor node of your SP system or cluster.  The squares are colored
  pink and yellow to show the instantaneous percent of CPU utilization
  for each processor node.  If a square were to appear all pink, the
  node would be at 0 percent utilization.  If a square were to appear
  all yellow, it would be at 100 percent utilization.  To the right of
  the Array is a node list which contains the name of each node shown in
  the Array.  The nodes are listed in the order in which they were
  contacted, left to right, starting with the top row of the Array.  You
  use this list to identify the name of a node represented in the Array.
 
  In order to use this tool, the Visualization Tool's Statistics
  Collector Daemon process (digd) needs to be running on each of the
  nodes you wish to monitor.  The daemon feeds the System Status Array
  with the CPU information it displays, and is created on each of your
  nodes as part of the Visualization Tool's installation procedure.  The
  digd statistics collector daemon can also feed information to the
  Visualization Tool.  If a square on the Array appears gray, the node
  is unavailable for monitoring.  It either does not have the Statistics
  Collector daemon running, or the Array cannot communicate with it.
 
 
  ENVIRONMENT VARIABLES
 
  MP_HOSTFILE         This environment variable is normally associated
                      with node allocation.  However, it is also checked
                      by the poestat command when running with the -norm
                      option.  It determines the name of a host list
                      file to use in selecting nodes for monitoring.  If
                      not set, the default is host.list in your current
                      directory.
 
  MP_RESD             Identifies whether or not node data received from
                      resource manager allocated nodes should be
                      filtered with a host list file.  If MP_RESD=yes,
                      and a host list file is specified, only those
                      nodes allocated by the resource manager and listed
                      in the host list file will be displayed.  This
                      option is useful if you would like to view
                      selected resource manager allocated nodes or view
                      up to 512 nodes.  To view 512 nodes, create two
                      host list files.  Each file can contain up to 255
                      nodes.  Set MP_HOSTFILE to one of the host list
                      files and start poestat in the background.  Set
                      MP_HOSTFILE to the other host list file and start
                      another poestat in the background.  Two instances
                      of poestat will be running, each displaying a
                      different set of 255 nodes.  If MP_RESD=no, the
                      resource manager node data will not be displayed
                      (similar to the -norm command line option).
 
  SP_NAME             Identifies the SP system Resource Manager name, if
                      used.  When running poestat from a workstation
                      that is external to an SP system, the ssp.clients
                      file set must be installed on the external node
                      (see IBM Parallel Environment for AIX:
                      Installation for more information).
 
 
  EXAMPLES
 
  To start the System Status Array as a background process when the SP
  system Resource Manager is available, enter:
 
    poestat &
 
  To start the System Status Array as a background process to monitor an
  RS/6000 network cluster, enter:
 
    poestat -norm &
 
  To display 512 resource manager nodes, enter:
 
    export MP_RESD=yes
    export MP_HOSTFILE= a host list file with 1st 255 nodes
    poestat &
    export MP_HOSTFILE= a host list file with 2nd 255 nodes
    poestat &
 
  RS/6000 network cluster, enter:
 
    poestat -norm &
 
  To display 512 resource manager nodes, enter:
 
    export MP_RESD=yes
    export MP_HOSTFILE= a host list file with 1st 255 nodes
    poestat &
    export MP_HOSTFILE= a host list file with 2nd 255 nodes
    poestat &
 
 
  FILES
 
  host.list  (Default host list file)
 
 
  RELATED INFORMATION
 
  Commands:  vt(1)