GMPPVIEW(SDSC)    UNIX System V (23 July 1997)     GMPPVIEW(SDSC)



  NAME
       gmppview - a text based up-to-the-second usage monitor

  SYNOPSIS
       gmppview [refresh rate in seconds]

  DESCRIPTION
       gmppview is a text-only usage display tool for the Cray T3E.
       It is designed to show much of the same information given by
       the text version of the Cray T3D command "mppview".

  INFORMATION DISPLAYED
       total application PEs
            The total number of application processing elements
            (PEs) the system is currently configured with.  These
            processors are reserved for multi-PE applications.

       available PEs
            The total number of application PEs not currently in
            use.

       largest contiguous group
            The largest contiguous group of application PEs.
            Multi-PE jobs run over contiguous groups of PEs, so
            this value indicates the largest job that could be
            added to the system.

       user The name of the user to which a particular multi-PE job
            belongs.

       pid  The process ID for a particular multi-PE job.

       PEs  The number of processing elements in use by a
            particular job.

       mode Denotes whether a particular job was run in batch (from
            the NQS scheduler) or interactively.  The elapsed
            execution time (see below) for certain batch and most
            interactive jobs can be used to estimate how much
            longer a job may continue (at SDSC most interactive
            jobs can run for no more than an hour, while the
            longest some batch jobs may run is 24 hours).

       state
            Indicates whether a job is currently executing or
            whether it is suspended.

       reason
            Indicates why a suspended job is waiting.  The most
            common reason "app.limit" indicates that a job is
            waiting for sufficient system resources (application
            PEs) to become available.

       elapsed
            The cumulative execution time for a running process.
            For a suspended process this value indicates the total
            wall-clock time spent waiting.

       command
            The command used to initiate a particular process.

  OPTIONS
       refresh rate
            The number of seconds between updates of the displayed
            information.  Since gmppview relies partially on the
            output of the "ps" command, refresh rates of less than
            about 7 seconds may not result in updates intervals of
            the specified duration.  This is because executing the
            "ps" command can require up to a few seconds.  The
            default refresh rate is 20 seconds.

  SEE ALSO
       mppview, xmppview, grmview, qstat, ps