bresize

release slots from a running resizable job, and cancel pending job resize allocation requests

Synopsis

bresize subcommand
bresize [-h | -V]

Description

Use bresize release to explicitly release slots from a running job. When releasing slots from an allocation, a minimum of 1 slot on the first execution host must be retained.

Use bresize cancel to cancel a pending allocation request for the specified job ID. The active pending allocation request is generated by LSF automatically for autoresizable jobs. If job does not have active pending request, the command fails with an error message.

By default, only cluster administrators, queue administrators, root and the job owner are allowed to run bresize to change job allocations.

User group administrators are allowed to run bresize to change the allocation of jobs within their user groups.

Subcommand List

release [-c] [-rnc resize_notification_cmd | -rncn] released_host_specification job_IDcancel job_ID-h-V

Options

-c

Optional. Cancel the active pending resource request when releasing slots from existing allocation. By default, the command only releases slots for jobs with pending requests.

-rnc resize_notification_cmd

Optional. Specify the name of an executable to be invoked on the first execution host when the job allocation has been modified. This setting only applies to this release request, which overrides any notification command specified in bsub or an application profile. The resize notification command runs under the user account of job.

-rncn

Cancels the resize notification command at both job-level and application-level. This setting only applies to this request.

released_host_specification
Required. Defines the list of hosts to be released. The following is the EBNF definition of the released host specification:
<released_host_spec> ::= all | all <exclude_host_list_spec>|<host_list_spec>
<host_list_spec> ::= <host_spec>|<host_list_spec><host_spec>
<exclude_host_list_spec> ::= <exclude_host_spec> | <exclude_host_list_spec> <exclude_host_spec>
<exclude_host_spec> ::= ~<host_spec>
<host_spec> ::= [<positive_integer>*]<host_name>
all

Specifies all the slots currently being used by the job. If all is used alone, it means release every slot except one slot from the first execution node. all can also be used with a list of hosts to exclude with the tilde (not) operator (~).

host_spec

Release the number of slots specified by positive_integer on the host specified by host_name. If the number of slots is not specified, all slots on specified host are released.

~

Specifies hosts to exclude when releasing slots. Slots on the specified hosts are not released. The tilde (not) operator (~) must be used together with all keyword.

job_ID

Required. The job ID of the job to be resized.

-h

Prints command usage to stderr and exits.

-V

Prints release version to stderr and exits.

Examples

For a job that uses 8 slots across 4 nodes: 2 on hostA 2 on hostB, 2 on hostC, and 2 on hostD, the following command releases all slots except hostA. After releasing, the job allocation becomes 2 on hostA:
bresize release "all ~hostA" 100
The following command releases all slots except 1 slot from hostA. After releasing, the job allocation becomes 1 on hostA:
bresize release all 100 or bresize release "all ~1*hostA" 100
The following command releases one slot from each of four hosts. After releasing, the job allocation becomes 1 on hostA, 1 on hostB, 1 on hostC, and 1 on hostD:
bresize release "1*hostA 1*hostB 1*hostC 1*hostD"  100

See also

bsub, lsb.applications