Automatic job re-queuing

You can configure a queue to automatically re-queue a job if it exits with a specified exit value.

  • The job is re-queued to the head of the queue from which it was dispatched, unless the LSB_REQUEUE_TO_BOTTOM parameter in lsf.conf is set.
  • When a job is re-queued, LSF does not save the output from the failed run.
  • When a job is re-queued, LSF does not notify the user by sending mail.
  • A job terminated by a signal is not re-queued.

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.

For example:
REQUEUE_EXIT_VALUES=all ~1 ~2 EXCLUDE(9)

Jobs exited with all exit codes except 1 and 2 are re-queued. Jobs with exit code 9 are re-queued so that the failed job is not rerun on the same host (exclusive job re-queue).