bgdel

Deletes job groups

Synopsis

bgdel [-u user_name | -u all] job_group_name | 0
bgdel -c job_group_name
bgdel -d idle_time
bgdel [-h | -V]

Description

Deletes a job group with the job group name specified by job_group_name and all its subgroups.

You must provide full group path name for the job group to be deleted. Deletion only takes effect after all jobs belonging to the group are cleaned out of mbatchd memory after the clean period.

Users can delete only their own job groups. LSF administrators can delete any job groups.

Job groups can be created explicitly or implicitly:
  • A job group is created explicitly with the bgadd command.
  • A job group is created implicitly by the the bsub -g or bmod -g command when the specified group does not exist. Job groups are also created implicitly when a default job group is configured (the DEFAULT_JOBGROUP in the lsb.params file, or the LSB_DEFAULT_JOBGROUP environment variable).

Options

0

Delete empty job groups. These groups can be explicit or implicit.

-u user_name

Delete empty job groups owned by the specified user. Only administrators can use this option. These groups can be explicit or implicit. If you specify a job group name, the -u option is ignored.

-u all

Delete empty job groups and their sub groups for all users. Only administrators can use this option. These groups can be explicit or implicit. If you specify a job group name, the -u option is ignored.

-c job_group_name

Delete all empty groups below the requested job_group_name including the job_group_name itself. These groups can be explicit or implicit.

job_group_name

Full path of the job group name.

-d idle_time

Delete job groups with an idle time that is larger than the specified idle_time. The unit of idle_time is in seconds.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Example

The following example deletes the job group /risk_group and all its subgroups:
bgdel /risk_group
Job group /risk_group is deleted.

See also

bgadd, bjgroup