bresume

Resumes one or more suspended jobs.

Synopsis

bresume [-app application_profile_name] [-C resume_reason] [-g job_group_name] [-J job_name] [-m host_name | -m host_group] [-q queue_name] [-sla service_class_name] [-u user_name | -u user_group | -u all] [0]

bresume [job_ID | "job_ID[index_list]"] ...

bresume [-h | -V]

Description

Sends the SIGCONT signal to resume one or more of your suspended jobs.

Only root and LSF administrators can operate on jobs that are submitted by other users. You cannot resume a job that is not suspended. Using the bresume command on a job that is not in either the PSUSP or the USUSP state has no effect.

You must specify a job ID or the -g, -J, -m, -u, or -q option. Specify 0 (zero) to resume multiple jobs.

You can also use the bkill -s CONT command to send the resume signal to a job.

If a signal request fails to reach the job execution host, LSF retries the operation later when the host becomes reachable. LSF retries the most recent signal request.

Jobs that are suspended by the administrator can be resumed only by the LSF administrator or root. Users do not have permission to resume a job that is suspended by another user or the administrator. Administrators or root can resume jobs that are suspended by users or administrators.

ENABLE_USER_RESUME parameter in the lsb.params file

If the ENABLE_USER_RESUME=Y parameter is set in the lsb.params file, users can resume their own jobs that are suspended by the administrator.

Options

0

Resumes all the jobs that satisfy other options (-g, -m, -q, -u, and -J).

-app application_profile_name

Resumes only jobs that are associated with the specified application profile. You must specify an existing application profile.

-C resume_reason

Specifies a reason for resuming the job, with a maximum length of 4095 characters. This reason is displayed in the bhist -l command output.

-g job_group_name

Resumes only jobs in the specified job group.

-J job_name

Resumes only jobs with the specified name.

The job name can be up to 4094 characters long. Job names are not unique.

The wildcard character (*) can be used anywhere within a job name, but it cannot appear within an array index. For example, the pattern job* returns jobA and jobarray[1]. The *AAA*[1] pattern returns the first element in job arrays with names that contain AAA. However, the pattern job1[*] does not return anything since the wildcard is within the array index.

-m host_name | -m host_group

Resumes only jobs that are dispatched to the specified host, host group, or combination.

-q queue_name

Resumes only jobs in the specified queue.

-sla service_class_name

Resume jobs that belong to the specified service class.

Use the bsla command to display the properties of service classes that are configured in the lsb.serviceclasses file and dynamic information about the state of each configured service class.

-u user_name | -u user_group | -u all

Resumes only jobs that are owned by the specified user or group, or all users if the reserved user name all is specified. To specify a Windows user account, include the domain name in uppercase letters and use a single backslash (DOMAIN_NAME\user_name) on a Windows command prompt or a double backslash (DOMAIN_NAME\\user_name) in a UNIX or Linux command line.

job_ID ... | "job_ID[index_list]" ...

Resumes only the specified jobs. Jobs that are submitted by any user can be specified here without using the -u option.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Examples

bresume -q night 0

Resumes all suspended jobs that belong to the user in the night queue. If the user is the LSF administrator, resumes all suspended jobs in the night queue.

bresume -g /risk_group 0

Resumes all suspended jobs in the job group /risk_group.