Resizable job commands

Commands for submission

Command

Description

bsub -app application_profile_name

Submits the job to the specified application profile configured for resizable jobs

bsub -app application_profile_name -rnc resize_notification_command

Submits the job to the specified application profile configured for resizable jobs, with the specified resize notification command. The job-level resize notification command overrides the application-level RESIZE_NOTIFY_CMD setting.

bsub -ar -app application_profile_name

Submits the job to the specified application profile configured for resizable jobs, as an autoresizable job. The job-level -ar option overrides the application-level RESIZABLE_JOBS setting. For example, if the application profile is not autoresizable, job level bsub -ar will make the job autoresizable.

Commands to monitor

Command

Description

bacct -l

  • Displays resize notification command.

  • Displays resize allocation changes.

bhist -l

  • Displays resize notification command.

  • Displays resize allocation changes.

  • Displays the job-level autoresizable attribute.

bjobs -l

  • Displays resize notification command.

  • Displays resize allocation changes.

  • Displays the job-level autoresizable attribute.

  • Displays pending resize allocation requests.

Commands to control

Command

Description

bmod -ar | -arn

Add or remove the job-level autoresizable attribute. bmod only updates the autoresizable attribute for pending jobs.

bmod -rnc resize_notification_cmd | -rncn

Modify or remove resize notification command for submitted job.

bresize release

Release allocated resources from a running resizable job.

  • Release all slots except one slot from the first execution node.

  • Release all hosts except the first execution node.

  • Release a list of hosts, with the option to specify slots to release on each host.

  • Specify a resize notification command to be invoked on the first execution host of the job.

Example:

bresize release "1*hostA 2*hostB hostC" 221

To release resources from a running job, the job must be submitted to an application profile configured as resizable.

  • 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.

bresize cancel

Cancel a pending allocation request. If job does not have active pending request, the command fails with an error message.

bresize release -rnc resize_notification_cmd

Specify or remove a resize notification command. The resize notification is invoked on the job first execution node. The resize notification command only applies to this release request and overrides the corresponding resize notification parameters defined in either the application profile (RESIZE_NOTIFY_CMD in lsb.applications) and job level (bsub -rnc notify_cmd), only for this resize request.

If the resize notification command completes successfully, LSF considers the allocation release done and updates the job allocation. If the resize notification command fails, LSF does not update the job allocation.

The resize_notification_cmd specifies the name of the executable to be invoked on the first execution host when the job's allocation has been modified.

The resize notification command runs under the user account that submitted the job.

-rncn overrides the resize notification command in both job-level and application-level for this bresize request.

bresize release -c

By default, if the job has an active pending allocation request, LSF does not allow users to release resource. Use the bresize release -c command to cancel the active pending resource request when releasing slots from existing allocation. By default, the command only releases slots.

If a job still has an active pending allocation request, but you do not want to allocate more resources to the job, use the bresize cancel command to cancel allocation request.

Only the job owner, cluster administrators, queue administrators, user group administrators, and root are allowed to cancel pending resource allocation requests.

Commands to display configuration

Command

Description

bapp

Displays the value of parameters defined in lsb.applications.