Submitting your job to a batch queue

The PPPL cluster uses PBS, the Portable Batch System (PBS), for job submission and job control.

To submit your job, ssh to portal, and execute the command qsub. This command submits a script to a job queue for execution to the PBS server phoenix. For example:
qsub myjobscript
submits the script for execution. This is called submitting a job to a batch queue.

The job will start executing when the resources required by the job are available. For example, if you submit a job that requires 24 nodes, the job will be started immediately if 24 nodes are available. However, if 24 nodes are not available, PBS will hold the job until nodes become available.

Monitoring your job

Use the qstat command to monitor jobs on the cluster.

To list the current jobs on the cluster:
qstat -a 
To list the currently running jobs on the cluster:
qstat -r 
To list a specific user's currently running jobs on the cluster:
qstat -u 'username' 
To lists nodes allocated to running jobs:
qstat -n 
To show detailed information on a specific job:
qstat -f <jobid>
To show detailed information for all queues
qstat -q

For a graphical display of batch job queues and jobs, use xpbs.

Man pages of PBS Commands