Command Reference Guide

bgmod
60 Platform LSF Command Reference
bgmod
modifies job groups
Synopsis
bgmod [-L limit | -Ln] job_group_name
bgmod [-h | -V]
Description
Modifies the job group with the job group name specified by job_group_name.
Only root, LSF administrators, the job group creator, or the creator of the parent job
groups can use
bgmod to modify a job group limit.
You must provide full group path name for the modified job group. The last
component of the path is the name of the job group to be modified.
Options
-L limit Changes the limit of job_group_name to the specified limit value. If the job group
has parent job groups, the new limit cannot exceed the limits of any higher level job
groups. Similarly, if the job group has child job groups, the new value must be
greater than any limits on the lower level job groups.
limit specifies the maximum number of concurrent jobs allowed to run under the
job group (including child groups)
-L limits the number of started jobs (RUN,
SSUSP, USSUP) under the job group.
Specify a positive number between 0 and 2147483647. If the specified limit is zero
(0), no jobs under the job group can run.
You cannot specify a limit for the root job group. The root job group has no job
limit. The -L option only limits the lowest level job group specified.
If a parallel job requests 2 CPUs (
bsub -n 2), the job group limit is per job, not per
slots used by the job.
-Ln Removes the existing job limit for the job group. If the job group has parent job
groups, the job modified group automatically inherits any limits from its direct
parent job group.
job_group_name Full path of the job group name.
-h Prints command usage to stderr and exits.
-V Prints LSF release version to stderr and exits.
Examples
The following command only modifies the limit of group
/canada/projects/test1. It does not modify limits of /canada
or
/canada/projects.
bgmod -L 6 /canada/projects/test1