PBS Batch Script Options
Courtesy of the Center of High Performance Computing
- -a date_time Declares the time after which the job is eligible for execution. the date_time element is in the form: [[[[CC]YY]MM]DD]hhmm[.S].
- -e path Defines the path to be used for the standard error stream of the batch job. The path is of the form: [hostname:]path_name.
- -h Specifies that a user hold will be applied to the job at submission time.
- -I Declares that the job is to be run "interactively". The job will be queued and scheduled as any PBS batch job, but when executed, the standard input, output, and error streams of the job are connected through qsub to the terminal session in which qsub is running.
- -j join Declares if the standard error stream of the job will be merged with the standard ouput stream of the job. The join argument is one of
- oe Directs the two streams as standard output.
- eo Directs the two streams as standard error.
- n Any two streams will be separate(Default).
- -l resource_list Defines the resources that are required by the job and establishes a limit to the amount of resource that can be consumed. Users will want to specify the walltime resource and if they wish to run a parallel job, the ncpus resource.
- -m mail_options Conditions under which the server will send a mail message about the job. The options are: n No mail ever sent. a (default) When the job aborts, b When the job begins, e When the job ends.
- -M user_list Declares the list of email addresses to whom mail is sent. If unspecified it defaults to userid@host from where the job was submitted. You will most likely want to set this option.
- -N name Declares a name for the job.
- -o path Defines the path to be used for the standard output. [hostname:]path_name
- -q destination The destination is the queue.
- -S path_list Declares the shell that interprets the job script. If not specified it will use the users login shell.
- -v variable_list Expands the list of environment variables which are exported to the job. The variable list is a comma separated list of strings of the form variable or variable=value.
- -V Declares that all environment variables in the qsub command's environment are to be exported to the batch job.
Example of Simple PBS Script
# This is a sample PBS script provided by MCSR Support Services.
# You should first read the PBS documentation at
# and then edit this script or create a new one to run your job.
# Interpret this job script using tsch
#PBS -S /bin/tcsh
# Send email to my account on this server when this job begins, ends, or aborts
#PBS -m abe
# Use a max of 1 CPU, 24 hours real time, 2 hours CPU time, and 100MB memory
# ncpus is used for the shared memory systems (redwood, sweetgum, onyx)
# If this were a mimosa job, the user would need to use nodes instead of ncpus
#PBS -l ncpus=1
#PBS -l walltime=24:00:00,cput=2:00:00
#PBS -l mem=100MB
# Name this job "my_simple_job"
#PBS -N my_simple_job
rm my_simple_job.o* # Remove any PBS output files from previous runs
rm my_simple_job.e* # Remove any PBS error files from previous runs
cd fortran # Change directories to my fortran directory
rm ./*.out # Remove any previous executables from this directory
f77 simple.f # compile my Fortran source program
./a.out >> simple.out # Run my program. Save output to "simple.out"
<< Previous Next>>