Managing jobs in the Oscar queue

Several command-line tools are available to help monitor and manage jobs that you have submitted to the queue.

allq

Displays an overview of all the queues, listing all running (R), queued (Q), and blocked (B) jobs. Tip: the list can be long, so to avoid scrolling back up the screen, pipe the list through the more utility with allq | more. You can also single out a queue with allq <queue>, e.g. allq serial will show only the serial queue.

myq

Displays an overview of only the jobs that you own, including an estimate of when your eligible jobs will run. You can also view another user's jobs with myq <username>.

qdel <jobid>

Delete one of your jobs from the queue. If it is running, the job will be terminated. You can find the "jobid" with either showq or myq (or, it is also returned when you initially submit the job with qsub).

qalter <options> <jobid>

Alter the properties of a job. The options have the same format as those preceded by #PBS in your batch script. For example, to change the requested number of nodes to 4 and the job name to 'NewName', you would use:

qalter -l nodes=4 -N NewName <jobid>

If the job is running, there are restrictions on what you can change. For instance, you can shorten the length of a running job, but you cannot increase it.