For fair share scheduling. Associates the job with the specified group or excludes the job from the specified groups.




bsub -G user_group
bsub -G "~user_group ..."


Specify any group that you belong to. You must be a direct member of the specified user group.

If you belong to multiple groups, use a tilde (~) to specify any fair share groups from which you want to exclude for the job. Use a space-separated list of tildes (~) to exclude multiple groups. If you exclude a middle node from a fair share tree, the descendant groups of that middle node are excluded along the specific path under the middle node.

For example, if there are two paths in the fair share tree to userA, which are /groupA/groupB/userA and /groupB/userA, and you specify bsub -G "~groupA", userA can still be associated with the path /groupB/userA.

If you are associating the job with a group, you cannot also exclude a group. For example, you cannot specify bsub -G "groupC ~groupD" to associate a job with groupC and to exclude the job from groupD.

If ENFORCE_ONE_UG_LIMITS is enabled in lsb.params, using the -G option enforces any limits placed on the specified user group only even if the user or user group belongs to more than one group and does not enforce limits on excluded user groups.

If ENFORCE_ONE_UG_LIMITS is disabled in lsb.params (default), using the -G option enforces the strictest limit that is set on any of the groups that the user or user group belongs to.


If ENFORCE_ONE_UG_LIMIT=Y is enabled, the following commands have the following effects:

  • bsub -G "group1"

    Associates the job with the group1 fair share group. If ENFORCE_ONE_UG_LIMIT=Y is enabled in the lsb.params file, limits apply only to group1 and its parents.

  • bsub -G "~group1 ~group2"

    Ensures that the job is never associated with group1 or group2. If ENFORCE_ONE_UG_LIMIT=Y is enabled in the lsb.params file, limits do not apply to group1 or group2.