LSF Version 7.3 - Administering Platform LSF

Administering Platform LSF 571
Job Starters
%USRCMD string The special string %USRCMD indicates the position of the job starter command in the
job command line. By default, the user commands run after the job starter, so the
%USRCMD string is not usually required. For example, these two job starters both give
the same results:
JOB_STARTER = /bin/csh -c
JOB_STARTER = /bin/csh -c "%USRCMD"
You must enclose the %USRCMD string in quotes. The %USRCMD string can be followed
by additional commands. For example:
JOB_STARTER = /bin/csh -c "%USRCMD;sleep 10"
If a user submits the following job to the queue with this job starter:
bsub myjob arguments
the command that actually runs is:
/bin/csh -c "myjob arguments; sleep 10"
For more
information
See the Platform LSF Configuration Reference for information about the
JOB_STARTER parameter in the
lsb.queues file.
Controlling Execution Environment Using Job Starters
In some cases, using bsub -L does not result in correct environment settings on the
execution host. LSF provides the following two job starters:
◆ preservestarter—preserves the default environment of the execution host.
It does not include any submission host settings.
◆ augmentstarter—augments the default user environment of the execution
host by adding settings from the submission host that are not already defined
on the execution host
bsub -L cannot be used for a Windows execution host.
Where the job starter executables are located
By default, the job starter executables are installed in LSF_BINDIR. If you prefer to
store them elsewhere, make sure they are in a directory that is included in the
default PATH on the execution host.
For example:
◆ On Windows, put the job starter under %WINDIR%.
◆ On UNIX, put the job starter under $HOME/bin.
Source code for the
job starters
The source code for the job starters is installed in LSF_MISC/examples.
Adding to the initial login environment
By default, the preservestarter job starter preserves the environment that RES
establishes on the execution host, and establishes an initial login environment for
the user with the following variables from the user’s login environment on the
execution host:
◆ HOME
◆ USER