Jobscript
General
A jobscript can be used to submit the job you wish to execute to a batch system. It is very similar to a sh-file and generally uses the same format, but is more powerful. Besides shell commands, you can put the so called magic cookie, e. g. #BSUB for LSF systems. This allows you to specify a lot of parameters, e. g. the time and memory your application requires or - if your code runs in parallel - the number of compute slots to employ.
Structure
Like a regular sh-file, your jobscript should start with a shebang (#!), e. g. in case you are using a z-shell:
#!/usr/bin/env zsh
Usually, this first line is followed by several directives using magic cookies, that are explained in more depth in the next section. The third part of a jobscript consists of shell commands, for example, to change to your working directory and to execute your application.
Magic Cookies
The magic cookie differs from system to system. Go here to figure out which one you're going to need. To use the magic cookie, start a new line in your script with it. Following that, you can set one of the parameters that are described on these pages, depending on your batch system: LSF, SLURM, Torque.
The big advantage of jobscripts is that the parameters that are prefixed with magic cookies are treated just like command line arguments. By setting them inside your jobscript already, it's easier to adjust them or look them up later.
Job Submission
This command submits your job to a batch system that controls the resources for computation.
$ bsub < jobscript.sh
Note that all incoming jobs (defined in a jobscript) are added to a queue. When to run a job, is decided by the scheduler. The waiting time depends on various factors, e. g. the time and memory you asked for in your jobscript. The rule of thumb is: the more resources your job needs, the longer it will be queued.
You can always check the current status (pend or run) of your submitted jobs and their ids with the following shell command. Once your jobs have finished, the command will print "No unfinished jobs found".
$ bjobs
In order to remove a job that you submitted, you can type this command:
$ bkill <job_id>