lsb_requeuejob

Requeues job arrays, jobs in job arrays, and individual jobs.

Use lsb_requeuejob to requeue job arrays, jobs in job arrays, and individual jobs that are running, pending, done, or exited. In a job array, you can requeue all the jobs or requeue individual jobs of the array.

lsb_requeuejob requeues jobs as if the jobs were in an array. A job not in an array is considered to be a job array composed of one job.

Jobs in a job array can be requeued independently of each other regardless of any job's status (running, pending, exited, done). A requeued job is requeued to the same queue it was originally submitted from or switched to. The job submission time does not change so a requeued job is placed at the top of the queue. Use lsb_movejob to place a job at the bottom or any other position in a queue.

If a clean period is reached before lsb_requeuejob is called, the cleaned jobs cannot be requeued. Set the variable CLEAN_PERIOD in your lsb.params file to determine the amount of time that job records are kept in MBD core memory after jobs have finished or terminated.

To requeue a job assign values to the data members of the jobrequeue data structure, process command line options in case the user has specified a different job, and call lsb_requeuejob to requeue the job array.

Assign values to the jobID, status, and options data members of the jobrequeue data structure. Assign the job identification number to jobID. Assign JOB_STAT_PEND or JOB_STAT_PSUSP to status. Assign REQUEUE_DONE, REQUEUE_EXIT, and or REQUEUE_RUN to requeue running jobs.

#include <lsf/lsbatch.h>

int lsb_requeuejob(struct jobrequeue * reqPtr)

Parameters:

*reqPtr

This structure contains the information required to requeue a job.

Data Structures:

jobrequeue

Define Statements:

requeuejob_options

Returns:

int:0
The function is successful.

int:-1
The function failed.

Errors:

On failure, lsberrno is set to indicate the error.

Equivalent line commands:

brequeue -d
brequeue -e
brequeue -a
brequeue -r
brequeue -H

Files:

$LSB_CONFDIR/cluster_name/configdir/lsb.params
$LSB_SHAREDIR

See also:

lsb_movejob

lsb_pendreason