Script Preservation
The qsub utility shall make the script available to the server
executing the batch job in such a way that the server executes
the script as it exists at the time of submission.
The qsub utility can send a copy of the script to the server with
the Queue Job Request or store a temporary copy of the script in
a location specified to the server.
Option Specification
A script can contain directives to the qsub utility.
The qsub utility shall scan the lines of the script for
directives, skipping blank lines, until the first line that
begins with a string other than the directive string; if
directives occur on subsequent lines, the utility shall ignore
those directives.
Lines are separated by a <newline>. If the first line of the
script begins with "#!"
or a <colon> (':'
), then it is skipped.
The qsub utility shall process a line in the script as a
directive if and only if the string of characters from the first
non-white-space character on the line until the first <space> or
<tab> on the line match the directive prefix. If a line in the
script contains a directive and the final characters of the line
are <backslash> and <newline>, then the next line shall be
interpreted as a continuation of that directive.
The qsub utility shall process the options and option-arguments
contained on the directive prefix line using the same syntax as
if the options were input on the qsub utility.
The qsub utility shall continue to process a directive prefix
line until after a <newline> is encountered. An implementation
may ignore lines which, according to the syntax of the shell that
will interpret the script, are comments. An implementation shall
describe in the conformance document the format of any shell
comments that it will recognize.
If an option is present in both a directive and the arguments to
the qsub utility, the utility shall ignore the option and the
corresponding option-argument, if any, in the directive.
If an option that is present in the directive is not present in
the arguments to the qsub utility, the utility shall process the
option and the option-argument, if any.
In order of preference, the qsub utility shall select the
directive prefix from one of the following sources:
* If the -C
option is presented to the utility, the value of
the directive_prefix option-argument
* If the environment variable PBS_DPREFIX is defined, the value
of that variable
* The four-character string "#PBS"
encoded in the portable
character set
If the -C
option is present in the script file it shall be
ignored.