bgmod

bgmod

modifies job groups

Synopsis

bgmod [-Llimit -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

-Llimit 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) -Llimits 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.

-LnRemoves 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 -h-V

Full path of the job group name.

Prints command usage to stderr and exits.

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

60Platform LSF Command Reference