Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

command

purpose

qsub jobscript

Submit job in script jobscript. Can accept other arguments as discussed above.

qsub -I -l nodes=1:ppn=4

Request interactive job with indicated resources.

qdel jobID

Delete job number jobID. Seems to kill processes on compute nodes cleanly.

showq

list jobs by state, with scheduling details.

showbf

list "backfill," or number of processors available at the moment.

qstat

List active jobs. Use "-i" for a different format.

qstat -q

List queue attributes for all queues.

qstat -f jobID

List detailed information for job number jobID.

qnodes

List all nodes and their state and properties.

qnodes -l down

List those nodes currently down.

qnodes -l active or qnodes -l active

List nodes currently used for jobs.

qnodes -l free

List nodes currently free.

qmgr -c "print server"

Print queue configuration details

administrative command

purpose

pbsnodes -o nodename

Take node offline after allowing current job to finish.

pbsndoes pbsnodes -r nodename

Check node and then return to free status if possible.

checkjob jobid

Check status of job.

releasehold -a jobid

Release holds on job.

qrun jobid

Force job to execute now.

showstats

Show usage statistics.

showgrid statistic_name

Print a text table of statistic_name by time.

The PBS queue system allocates a set of nodes and processors to an individual job, either for the walltime specified in the job or the maximum walltime in the queue. It then provides a set of environmental variables to the shell in which the script runs, such as PBS_NODEFILE, the temporary node file describing allocated CPUs. When running with OpenMPI's mpiexec, the submitted script seems to just launch processes without needing that nodefile specified as an argument to mpiexec, although it's not clear whether that behavior is a feature or a bug.

Additional information for queue administrators on Maui can be found on a helpful page maintained by the University of Cambridge's Theoretical Chemistry department: Maui administration

Anchor
queue_tables
queue_tables

...