ASMA JOB SUBMISSION GUIDE
Asma users are required to use PBS(Portable
Batch System) to submit their jobs to the cluster. This guide is prepared
to explain the job submissions through PBS on ASMA. Mail to info@asma.cmpe.boun.edu.tr
for your questions and problems.
For more information on PBS, see:
(Top)GENERAL
INFO ON PBS JOB SUBMISSION
We defined a single queue called "dque" for job submissions. After submission,
your job will be queued. If the resources required by your job are available,
your job will be executed.
The users have to prepare a job script in which they request the resources
and declare the commands to be executed.
If multiple nodes are requested, the job script will be executed only on
the master node of the granted nodes.
Several commented sample scripts can be found under /etc/skel/PBS on ASMA
front end. You can copy and change them according to your needs.
The job script is submitted to the execution queue via the qsub command.
See the sample scripts below on this page for detailed explanations.
(Top)BASIC
USER COMMANDS
qsub : Submits job script. You can submit
a job script via the following command:
qsub myscript
See the qsub man page for the parameters and variables used in the job
scripts.
qstat : Displays queue status. The following
command shows the current status of the queue on ASMA:
qstat -q dque ( or just "qstat" since there is no
other queue defined in the system )
In the ouput of qstat, the S column shows the state of the job. The
state can be one of the following:
E - job is exiting after having run.
H - job is held.
Q - job is queued, eligable to run or routed.
R - job is running.
T - job is being moved to new location.
W - job is waiting for its execution time (-a option) to be reached.
NOTE: Just after you submit your job to the queue, you
will see that your job is not executed immediately even if all the resource
requirements are satisfied. This is because the scheduler checks the submissions
every 10 seconds.
qdel : Deletes jobs from a queue. You can
delete a submitted job by giving its job id. Job id can be learned from
the output of qsub(just after the submission of the job) or qstat commands.
For example, if your job id is "58.asma" then you can delete it by the
following command:
qdel 58.asma
(Top)GAUSSIAN
JOB SUBMISSION SCRIPT EXAMPLE (/etc/skel/PBS/g98.scr)
(Top)MPI
JOB SUBMISSION SCRIPT EXAMPLE(/etc/skel/PBS/mpi.scr)
(Top)REGULAR
SHELL JOB SUBMISSION SCRIPT EXAMPLE(/etc/skel/PBS/sh.scr)