bgadd

creates job groups

Synopsis

bgadd [-L limit] [-sla service_class_name] job_group_name
bgadd [-h | -V]

Description

Creates a job group with the job group name specified by job_group_name.

You must provide full group path name for the new job group. The last component of the path is the name of the new group to be created.

You do not need to create the parent job group before you create a sub-group under it. If no groups in the job group hierarchy exist, all groups are created with the specified hierarchy.

Options

-L 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, USUSP) 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. Job groups added with no limits specified inherit any limits of existing parent job groups. The -L option only limits the lowest level job group created.

If a parallel job requests 2 CPUs (bsub -n 2), the job group limit is per job, not per slots used by the job.

By default, a job group has no job limit. Limits persist across mbatchd restart or reconfiguration.

-sla service_class_name

The name of a service class defined in lsb.serviceclasses, or the name of the SLA defined in ENABLE_DEFAULT_EGO_SLA in lsb.params. The job group is attached to the specified SLA.

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

  • Create a job group named risk_group under the root group /:
    bgadd /risk_group
  • Create a job group named portfolio1 under job group /risk_group:
    bgadd /risk_group/portfolio1

See also

bgdel, bjgroup