LSF Version 7.3 - Platform LSF Configuration Reference

option values or rejects the job. Because an esub runs before job submission, using an esub to reject incorrect job

submissions improves overall system performance by reducing the load on the master batch daemon (mbatchd).

An esub can be used to:

•

Reject any job that requests more than a specified number of CPUs

•

Change the submission queue for specific user accounts to a higher priority queue

•

Check whether the job specifies an application and, if so, submit the job to the correct application profile

Note:

If an esub executable fails, the job will still be submitted to LSF.

Multiple esub executables

LSF provides a master external submission executable (LSF_SERVERDIR/mesub) that supports the use of application-

specific esub executables. Users can specify one or more esub executables using the -a option of bsub or bmod. When

a user submits or modifies a job or when a user restarts a job that was submitted or modified with the -a option included,

mesub runs the specified esub executables.

An LSF administrator can specify one or more mandatory esub executables by defining the parameter

LSB_ESUB_METHOD in lsf.conf. If a mandatory esub is defined, mesub runs the mandatory esub for all jobs

submitted to LSF in addition to any esub executables specified with the -a option.

The naming convention is esub.application. LSF always runs the executable named

"esub" (without .application) if it exists in LSF_SERVERDIR.

Note:

All esub executables must be stored in the LSF_SERVERDIR directory defined in

lsf.conf.

The mesub runs multiple esub executables in the following order:

The mandatory esub or esubs specified by LSB_ESUB_METHOD in lsf.conf

Any executable with the name "esub" in LSF_SERVERDIR

One or more esubs in the order specified by bsub -a

Example of multiple esub execution

An esub runs only once, even if it is specified by both the bsub -a option and the parameter LSB_ESUB_METHOD.

Feature: External job submission and execution controls

68 Platform LSF Configuration Reference