pmarray
 
 
  NAME
 
  pmarray - Starts the Program Marker Array, which is an X-Windows tool
  for monitoring a parallel executable's run.
 
 
  SYNOPSIS
 
  pmarray
 
  The pmarray command starts the Program Marker Array X-Windows tool
  prior to invoking poe.  This tool is used for run-time monitoring.
 
 
  FLAGS
 
  None.
 
 
  DESCRIPTION
 
  The pmarray command starts the Program Marker Array.  This X-Windows
  run-time monitoring tool consists of a number of small squares, or
  lights.  Each task in a parallel program has its own row of lights.
  Using calls to the Parallel Utility Functions enables a parallel
  program to control the appearance of the Program Marker Array Window.
  Calls to MP_MARKER (for Fortran programs) or mpc_marker (for C
  programs) enables a program to color lights on, and/or send output
  strings to the Window.  Calls to MP_NLIGHTS (for Fortran programs) and
  mpc_nlights (for C programs) enables a program to determine the number
  of lights displayed per task row.
 
 
  ENVIRONMENT VARIABLES
 
  This command responds to the following environment variables:
 
  MP_PMLIGHTS         Indicates the number of lights displayed per row
                      on the Array.  (If, when you invoke poe, you
                      override MP_PMLIGHTS using the -pmlights flag, the
                      Array will redisplay with the new number of lights
                      per row.)
 
  MP_PROCS            Indicates the number of program tasks.  The
                      pmarray command sets the number of task rows
                      displayed in the Array equal to the value of
                      MP_PROCS.  (If, when you invoke poe, you override
                      MP_PROCS using the -procs flag, the Array will
                      redisplay with the new number of rows.)
 
  MP_USRPORT          Indicates the port id used by the Partition
                      Manager to connect to the Array.  By default, the
                      Partition Manager connects to the Array using a
                      socket assigned to port 9999.  If you get an error
                      message indicating that the port is in use,
                      specify a different port.  Standard TCP/IP
                      practice suggests using ports greater than 5000
                      and less than 10000.
 
 
  EXAMPLES
 
  To start the Program Marker Array program as a background process, and
  open its window, enter:
 
    pmarray &
 
 
  FILES
 
  /usr/lib/X11/app-defaults/PMarray  (Xdefaults file)
 
  /usr/lib/ppe.poe/samples/PMarray.ad  (X-Windows resource information)
 
 
  RELATED INFORMATION
 
  Commands:  poe(1)
 
  Subroutines:  mpc_marker(3), MP_MARKER(3), mpc_nlights(3),
  MP_NLIGHTS(3)