5.671 Job Submission

Job submission is accomplished using the qsub command, which takes a number of command line arguments and integrates such into the specified PBS command file. The PBS command file may be specified as a filename on the qsub command line or may be entered via STDIN.

The PBS command file does not need to be executable.
The PBS command file may be piped into qsub (i.e., cat pbs.cmd | qsub).
In the case of parallel jobs, the PBS command file is staged to, and executed on, the first allocated compute node only. (Use pbsdsh to run actions on multiple nodes.)
The command script is executed from the user's home directory in all cases. (The script may determine the submission directory by using the $PBS_O_WORKDIR environment variable)
The command script will be executed using the default set of user environment variables unless the -V or -v flags are specified to include aspects of the job submission environment.
PBS directives should be declared first in the job script.
```
#PBS -S /bin/bash
#PBS -m abe
#PBS -M <[email protected]>
echo sleep 300
```
This is an example of properly declared PBS directives.
```
#PBS -S /bin/bash
SOMEVARIABLE=42
#PBS -m abe
#PBS -M <[email protected]>
echo sleep 300
```
This is an example of improperly declared PBS directives. PBS directives below "SOMEVARIABLE=42" are ignored.

By default, job submission is allowed only on the Torque server host (host on which pbs_server is running). Enablement of job submission from other hosts is documented in Server Configuration.

Versions of Torque earlier than 2.4.5 attempted to apply queue and server defaults to a job that didn't have defaults specified. If a setting still did not have a value after that, Torque applied the queue and server maximum values to a job (meaning, the maximum values for an applicable setting were applied to jobs that had no specified or default value).

In Torque 2.4.5 and later, the queue and server maximum values are no longer used as a value for missing settings.

This section contains these topics: