bjgroup

displays information about job groups

Synopsis

bjgroup [-N] [-s [group_name]]
bjgroup [-h | -V]

Description

Displays job group information.

When LSF adds more resources to a running resizable job, bjgroups displays the added resources. When LSF removes resources from a running resizable job, bjgroups displays the updated resources.

Options

-s

Sorts job groups by group hierarchy.

For example, for job groups named /A, /A/B, /X and /X/Y, bjgroup without -s displays:
bjgroup
GROUP_NAME         NJOBS   PEND    RUN    SSUSP  USUSP  FINISH  SLA   JLIMIT  OWNER
/A                 0       0       0      0      0      0       ()      0/10  user1
/X                 0       0       0      0      0      0       ()       0/-  user2
/A/B               0       0       0      0      0      0       ()       0/5  user1
/X/Y               0       0       0      0      0      0       ()       0/5  user2
For the same job groups, bjgroup -s displays:
bjgroup -s
GROUP_NAME         NJOBS   PEND    RUN    SSUSP  USUSP  FINISH  SLA   JLIMIT  OWNER
/A                 0       0       0      0      0      0       ()       0/10  user1
/A/B               0       0       0      0      0      0       ()       0/5  user1
/X                 0       0       0      0      0      0       ()       0/-  user2
/X/Y               0       0       0      0      0      0       ()       0/5  user2
Specify a job group name to show the hierarchy of a single job group:
bjgroup -s /X
GROUP_NAME   NJOBS  PEND   RUN   SSUSP  USUSP  FINISH       SLA   JLIMIT  OWNER
/X              25     0    25       0      0       0   puccini  25/100   user1
/X/Y            20     0    20       0      0       0   puccini   20/30   user1
/X/Z             5     0     5       0      0       0   puccini    5/10   user2
Specify a job group name with a trailing slash character (/) to show only the root job group:
bjgroup -s /X/
GROUP_NAME   NJOBS  PEND   RUN   SSUSP  USUSP  FINISH      SLA   JLIMIT  OWNER
/X               25    0    25       0      0       0   puccini  25/100  user1
-N
Displays job group information by job slots instead of number of jobs. NSLOTS, PEND, RUN, SSUSP, USUSP, RSV are all counted in slots rather than number of jobs:
bjgroup -N
GROUP_NAME NSLOTS PEND   RUN   SSUSP  USUSP   RSV      SLA     OWNER
/X             25    0    25       0      0     0  puccini     user1
/A/B           20    0    20       0      0     0   wagner     batch
-N by itself shows job slot info for all job groups, and can combine with -s to sort the job groups by hierarchy:
bjgroup -N -s
GROUP_NAME NSLOTS PEND   RUN   SSUSP   USUSP  RSV      SLA     OWNER
/A              0    0     0       0       0    0   wagner      batch
/A/B            0    0     0       0       0    0   wagner      user1
/X             25    0    25       0       0    0   puccini     user1
/X/Y           20    0    20       0       0    0   puccini     batch
/X/Z            5     0    5       0       0    0   puccini     batch
-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Default output

A list of job groups is displayed with the following fields:

GROUP_NAME

The name of the job group.

NJOBS

The current number of jobs in the job group. A parallel job is counted as 1 job, regardless of the number of job slots it uses.

PEND

The number of pending jobs in the job group.

RUN

The number of running jobs in the job group.

SSUSP

The number of system-suspended jobs in the job group.

USUSP

The number of user-suspended jobs in the job group.

FINISH

The number of jobs in the specified job group in EXITED or DONE state.

SLA

The name of the service class that the job group is attached to with bgadd -sla service_class_name. If the job group is not attached to any service class, empty parentheses () are displayed in the SLA name column.

JLIMIT

The job group limit set by bgadd -L or bgmod -L. Job groups that have no configured limits or no limit usage are indicated by a dash (-). Job group limits are displayed in a USED/LIMIT format. For example, if a limit of 5 jobs is configured and 1 job is started, bjgroup displays the job limit under JLIMIT as 1/5.

OWNER

The job group owner.

Example

bjgroup
GROUP_NAME  NJOBS  PEND   RUN   SSUSP  USUSP  FINISH      SLA   JLIMIT  OWNER
/fund1_grp      5     4     0       1      0      0   Venezia     1/5   user1
/fund2_grp     11     2     5       0      0      4   Venezia     5/5   user1
/bond_grp       2     2     0       0      0      0   Venezia     0/-   user2
/risk_grp       2     1     1       0      0      0        ()     1/-   user2
/admi_grp       4     4     0       0      0      0        ()     0/-   user2

Job slots (-N) output

NSLOTS, PEND, RUN, SSUSP, USUSP, RSV are all counted in slots rather than number of jobs. A list of job groups is displayed with the following fields:

GROUP_NAME

The name of the job group.

NSLOTS

The total number of job slots held currently by jobs in the job group. This includes pending, running, suspended and reserved job slots. A parallel job that is running on n processors is counted as n job slots, since it takes n job slots in the job group.

PEND

The number of job slots used by pending jobs in the job group.

RUN

The number of job slots used by running jobs in the job group.

SSUSP

The number of job slots used by system-suspended jobs in the job group.

USUSP

The number of job slots used by user-suspended jobs in the job group.

RSV

The number of job slots in the job group that are reserved by LSF for pending jobs.

SLA

The name of the service class that the job group is attached to with bgadd -sla service_class_name. If the job group is not attached to any service class, empty parentheses () are displayed in the SLA name column.

OWNER

The job group owner.

Example

bjgroup -N
GROUP_NAME NSLOTS PEND   RUN   SSUSP  USUSP   RSV      SLA     OWNER
/X             25    0    25       0      0     0  puccini     user1
/A/B           20    0    20       0      0     0   wagner     batch

See also

bgadd, bgdel, bgmod