Explanation of the Visual Queue Display

Queues

Queue Screenshot
  • Appear as rectangles on the left side of the screen
  • Are either occupied or empty. When empty, queues are usually shown minimized and below occupied queues. Queues that have only recently become empty may still appear in expanded format.
  • Interactivity (left-clicking a queue):
    • Displays a tooltip with the following information:
      • Target expansion factor (EF) of the queue
      • Number of jobs in the queue and their weighted EF
      • Number of jobs from the queue that are currently running and their weighted EF
      • Total number of processors running jobs from the queue
    • Highlights (in pink) the processors that are currently running jobs from the queue

Queued Jobs

Queued Jobs Screenshot
  • Are represented by circles
  • Are sized according to the requested number of CPUs
  • Display the requested number of CPUs
  • Are colored by EF with respect to the target EF of the queue. Queued jobs are colored as follows:
    • The color scale for queued jobs goes from green (recently submitted) to red (wait time exceeds the allowed wait time as set by the target EF) with yellow in between.
    • Jobs are colored gray when their queue does not have a target EF.
    • Suspended jobs are shown in cyan.
  • Are placed in job groups when the queue, user, number of CPUs, and requested wall clock time are the same. Job groups are shown as the job circle with a square border; the number of jobs in the group appears in the top-right corner of the job group.
  • Interactivity (left-clicking a queued job):
    • Displays a tooltip with some or all of the following information:
      • Job ID, username, number of cpus, requested wallclock limit
      • Submit time, wait time, EF, User CPH
      • Number of jobs that the user has queued and/or running
    • Highlights (in pink) all queued and running jobs that belong to the owner of the clicked job

Machines

Machines Screenshot
  • Appear as rectangular grids on the right side of the screen
  • Each "grid square" represents one or more processors (as specified in the machine tooltip).
  • Processor colors are as follows:
    • cyan - reserved for system use
    • white - free (not running a job)
    • light to dark blue - running a job
    • red - running a job that has exceeded its requested wallclock time
  • Interactivity (left-clicking the title area of a machine):
    • Displays a tooltip with the following information:
      • Machine name and description
      • Total CPUs, user CPUs, and free CPUs
      • Number of processors represented by each square (if greater than one)

Running Jobs

Running Jobs Screenshot
  • Are colored by runtime with respect to the job's requested wallclock time. The color scale for running jobs goes from light blue (recently started) to dark blue (nearing completion).
  • Are colored red when the job's runtime has exceeded its requested wallclock time.
  • Interactivity (left-clicking the processors of a running job):
    • Displays a tooltip with the following information:
      • Job ID, username, number of cpus, requested wallclock limit, originating queue
      • Submit time, elapsed wait time, EF
      • Start time, elapsed run time, remaining run time, job's CPH
      • Number of jobs that the user has queued and/or running
    • Highlights (in pink) the clicked job

Moving Jobs

Moving Jobs Screenshot
  • When a queued job starts, the job circle flies from the queue to the processors of the machine on which it will run. While the job circle is enroute to the machine, the machine's processors that are assigned to the job turn the same color as the job. Upon arrival of the job at the machine, the job "melts into the machine, and the processors turn light blue.
  • When a running job exits normally (according to the scheduler), it becomes a circle again and flies off the right side of the screen.

Explosions and Hands

Explosions Screenshot
  • When a running job exits abnormally, an animated explosion is shown in place of the job and a sound effect is played (you must have a sound card and speakers connected to hear it!)
Hands Screenshot
  • When a user cancels a queued job, an animated hand reaches from the left side of the screen, grabs the job circle, and takes the job from the queue.

Finding Particular Jobs

  • One can quickly find a particular job by using the following selection dialogs:
    • Find jobs by user
    • Find jobs by job ID
    • Find jobs that will end soon
  • These selection dialogs are available from a pop-up menu that appears upon right-clicking the applet.
  • Queued and/or running jobs that match the selection criteria will be highlighted (in pink).