Configure exclusive job requeue

Procedure

Set REQUEUE_EXIT_VALUES in the queue definition (lsb.queues) and define the exit code using parentheses and the keyword EXCLUDE:

EXCLUDE(exit_code...)

exit_code has the following form:

"[all] [~number ...] | [number ...]"

The reserved keyword all specifies all exit codes. Exit codes are typically between 0 and 255. Use a tilde (~) to exclude specified exit codes from the list.

Jobs are requeued to the head of the queue. The output from the failed run is not saved, and the user is not notified by LSF.

Results

When a job exits with any of the specified exit codes, it is requeued, but it is not dispatched to the same host again.

Example

Begin Queue 
... 
REQUEUE_EXIT_VALUES=30 EXCLUDE(20) HOSTS=hostA hostB hostC 
... 
End Queue

A job in this queue can be dispatched to hostA, hostB or hostC.

If a job running on hostA exits with value 30 and is requeued, it can be dispatched to hostA, hostB, or hostC. However, if a job running on hostA exits with value 20 and is requeued, it can only be dispatched to hostB or hostC.

If the job runs on hostB and exits with a value of 20 again, it can only be dispatched on hostC. Finally, if the job runs on hostC and exits with a value of 20, it cannot be dispatched to any of the hosts, so it is pending forever.