ACCC Home Page Academic Computing and Communications Center  
Accounts / Passwords Email Labs / Classrooms Telecom Network Security Software Computing and Network Services Education / Teaching Getting Help
 

The qstat command

     
 
     
Overview
 

All user jobs are run by torque.

Clients assume that a submitted job immediately starts running. As stated earlier, a job may not run and will queue (wait) if the requested resources are unavailable or if the request exceeds a defined limit for the user or for the queue. The qstat command tells you if the job is running, where it is running, and for how long. It will also tell you if the job is not running.

 
     
Syntax
 

qstat options

 
     
Sample output
 
  • Sample #1:
      Job id  Name      User      Time Used S Queue
      ------  ----   ---------    --------  - ----- 
      1232    my_job1   jsmith    192:34:2  R staff
      1233    my_job2   jsmith    192:31:5  R staff
      1252    my_job3   bob1             0  Q student_long
    

    The two jobs owned by user jsmith are running, so indicated by the R (for running) in the S (Status) column. The job, my_job3 owned by the student bob1, is queued, so indicated by the Q in the status column.

  • Sample #2 (edited somewhat to fit herein):
      JobID Username  Queue    Jobname  SessID NDS TSK Time  S Time
      ----- -------   -------- -------- ------ --- --- ----- - -----
      1232  jsmith    staff    my_job1  31047  1   1   720:0 R 193:0
      1233  jsmith    staff    my_job2  28986  1   1   720:0 R 192:5
      1252  bob1      student_ my_job3     --  4   1   240:0 Q   --  
    
  • Sample #3:
      Job ID  Username Queue  Jobname  SessID NDS TSK Memory Time  S Time
      ------  -------- ------ -------- ------ --- --- ------ ---- -- ----
      1232    jsmith   staff  my_job1  31047   1   1    --   720:0 R 193:1
        argo2-4/0
 
     
Examples of the qstat command
 
Command
Description
qstat -an Give me a listing of ALL jobs (-a) and the nodes allocated to each one (n)
qstat -u netid Give me a listing of ONLY my jobs (-u your netid) (running or awaiting execution)
qstat -nu netid Give me a listing of my jobs (-u your netid) and the nodes allocated to them (n)
qstat id Give me information regarding a particular job (id)
qstat -n id Give me information, including the nodes assigned (-n), regarding a particular job (id)
qstat -f id Give me detailed information (-f) regarding a particular job (id)
qstat -q Give me information, including default and maximum walltime, about all of the queues (-q)
 
     
Documentation
 
  • For detailed information about the qstat command, see the man page (man qstat).

 

 


2010-8-26  ACCC Systems Group
UIC Home Page Search UIC Pages Contact UIC