Center for High-Performance Computing and Communications

Useful PBS Commands

This document contains a list of useful Portable Batch System (PBS) commands.  The man pages for the PBS commands are available on hpc-login1 and hpc-login2.

More information about the TORQUE resource manager (PBS) and the Moab Cluster Scheduler can be found at Adaptive Computing’s official documentation website, located at www.adaptivecomputing.com/resources/docs/


PBS commands

qsub: submits PBS job

typical usage:

qsub [-A account] script


qdel: deletes PBS job

typical usage:

qdel job_identifier


qstat: shows the status of PBS jobs

typical usage:

qstat -f job_identifier


pbstop: shows the current status of the cluster nodes


qbalance: shows the QBank account balance

typical usage:

qbalance [-a account] [-u user] -h


showstart: shows the approximate starting time of the job

typical usage:

showstart job_identifier


checkjob: shows the current status of the job

typical  usage:

checkjob job_identifier


checknode: shows the status of the node

typical usage:

checknode node_identifier


pbsnodes: shows the detail of nodes

typical usage:

pbsnodes -a

To list the count of unique nodes along with the properties of those nodes:

pbsnodes -a | grep properties | sort | uniq -c


pbsdsh: distributes task to nodes under pbs

typical usage:

pbsdsh executable [args]

This command copies the inputfile into /tmp directory of each node:

pbsdsh cp inputfile /tmp


mpiexec: initializes parallel job

typical usage:

mpiexec executable [args]

This command copies the input file into /tmp directory of each node:

mpiexec -comm=none -pernode cp inputfile /tmp


Getting Help

If you need assistance with this or any HPCC function, please send an email to hpcc@usc.edu.