bjgroup

-s

Sorts job groups by group hierarchy.

For example, for job groups named /A, /A/B, /X and /X/Y, the bjgroup command without the -s option displays the following information:

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, the bjgroup -s command displays the following information:

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. The values for 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

The -N option by itself shows job slot info for all job groups. Combine with the -s option 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.

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.

IDLE_TIME

The idle time value of each job group. If the job group currently has jobs, never had jobs, or at least one of its sub-groups never had jobs, the IDLE_TIME value is 0.

bjgroup

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

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 the bgadd -sla service_class_name coammand. 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.