MIT Information Systems    Longjobs -- Checking Job Status
Athena Owl    On this page: Job status | Queue status | Quota

Understanding longjobs queues

When viewing queue status, keep in mind that predicting wait time is difficult. Unlike a simple print queue, this is not a strict first-in-first-out system; viewing the queues should give you some idea of system demand but scheduling order and wait time will depend on several factors.

There are 3 factors determining scheduling priority for a job:

Of these, queue wait and recent usage will probably be given relatively greater weight, but the algorithm is subject to adjustment for fairness.

Wait time will also depend on the number of execution machines available:


Job status

The command for viewing job status is qstat. Without arguments, it displays status for all jobs currently in the system. For example:

athena% qstat

Job ID      Username  Queue         Jobname     Limit  State  Elapsed
------      --------  -----         -------     -----  -----  -------
240         hmprof    sun-long      STDIN       27:00  Hold   --
379         jqpublic  sun-long      foo         27:00  Run    00:03
385         jpqublic  sun-medium    STDIN       06:00  Que    --
386         llta      sun-medium    bar1        06:00  Run    00:02
387         llta      linux-long    bar2        27:00  Run    13:37

Syntax for other common options:

The possible states are:
      Run     (running)
      Que     (queued)
      Hold    (on hold, per user, admin, or system)
      Wait    (time wait, if specified via qsub -A)
      Exit    (exiting)
      Trans   (in transit - not yet committed, or being routed)
      Susp    (suspended)
You can also obtain job status via the longjob -jobs interface. Currently this simply invokes qstat -l.

Queue status

When viewing queue status, bear in mind how longjobs queues work.

To view all jobs in a particular queue, use:   qstat queue
For example:

athena% qstat sun-long

Job ID      Username  Queue         Jobname     Limit  State  Elapsed
------      --------  -----         -------     -----  -----  -------
240         hmprof    sun-long      STDIN       27:00  Hold   --
379         jqpublic  sun-long      foo         27:00  Run    22:03
390         llta      sun-long      bar2        27:00  Run    13:37
403         llta      sun-long      bar3        15:00  Que    --

To view a summary of all queues use:  qstat -q
For example:

athena% qstat -q

Queue             Limit  Run  Que  State
----------------  -----  ---  ---  -----
any-medium        06:00    0    0
any-long          27:00    0    0
sun-medium        06:00    1    4
sun-long          27:00    0    1
linux-medium      06:00    0    0
linux-long        27:00    1    0
29.123-res        27:00    1    3  Inaccessible
                         ---  ---
                           3    8
Notes: You can also run the command longjob -queues to display a summary of all configured queues.

Quota

To view your quota information, use:   qusage
For example:

athena% qusage

Account           Remain   Queued   Running   Expires
-------           ------   ------   -------   --------
29.123             54:16     0:00    27:00    01/01/02
jqpublic           30:17     0:00     0:00    02/03/04

For more detail (including the total quota allocated for each account), use:   qusage -l
For example:

athena% qusage -l

Account           Remain   Queued   Running   Expires
-------           ------   ------   -------   --------
29.123             97:30     0:00     6:00    Jan 01 2002
   Allocation: 100   Platforms: any   Created: Dec 29 2000   Modified: Feb 15 2001
jqpublic           30:17     0:00     0:00    Feb 03 2004
   Allocation:  35   Platforms: sun   Created: Jan 06 2001   Modified: Feb 15 2001

You can also use the command longjob -quota to view your quota information.
Longjobs Documentation: Overview | Job Scripts | Running Jobs | Checking Job Status (this page) | Quick Reference and FAQ

Last modified: Mon Jul 21 11:39:41 EDT 2003