LSF Version 7.3 - Administering Platform LSF

Administering Platform LSF 127
Managing Jobs
Using Job Groups
A collection of jobs can be organized into job groups for easy management. A job
group is a container for jobs in much the same way that a directory in a file system
is a container for files. For example, a payroll application may have one group of
jobs that calculates weekly payments, another job group for calculating monthly
salaries, and a third job group that handles the salaries of part-time or contract
employees. Users can submit, view, and control jobs according to their groups
rather than looking at individual jobs.
How job groups are created
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 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 (DEFAULT_JOBGROUP in
lsb.params or
LSB_DEFAULT_JOBGROUP environment variable).
Job groups created when jobs are attached to an SLA service class at submission are
implicit job groups (
bsub -sla service_class_name -g job_group_name). Job
groups attached to an SLA service class with
bgadd are explicit job groups
(
bgadd -sla service_class_name job_group_name).
The GRP_ADD event in
lsb.events indicates how the job group was created:
◆ 0x01 - job group was created explicitly
◆ 0x02 - job group was created implicitly
For example:
GRP_ADD" "7.02" 1193032735 1285 1193032735 0 "/Z" "" "user1" "" "" 2 0 "" -1 1
means job group /Z is an explicitly created job group.
Child groups can be created explicitly or implicitly under any job group.
Only an implicitly created job group which has no job group limit (
bgadd -L) and
is not attached to any SLA can be automatically deleted once it becomes empty. An
empty job group is a job group that has no jobs associated with it (including
finished jobs). NJOBS displayed by bjgroup is 0.
Job group hierarchy
Jobs in job groups are organized into a hierarchical tree similar to the directory
structure of a file system. Like a file system, the tree contains groups (which are like
directories) and jobs (which are like files). Each group can contain other groups or
individual jobs. Job groups are created independently of jobs, and can have
dependency conditions which control when jobs within the group are considered
for scheduling.
Job group path
The job group path is the name and location of a job group within the job group
hierarchy. Multiple levels of job groups can be defined to form a hierarchical tree.
A job group can contain jobs and sub-groups.