busers

displays information about users and user groups

Synopsis

busers [-w] [user_name ... | user_group ... | all]
busers [-h | -V]

Description

Displays information about users and user groups.

By default, displays information about the user who runs the command.

When a resizable job has a resize allocation request, busers displays pending requests. When LSF adds more resources to a running resizable job, busers decreases job PEND counts and displays the added resources. When LSF removes resources from a running resizable job, busers displays the updated resources.

Options

user_name ... | user_group ... | all

Displays information about the specified users or user groups, or about all users if you specify all. To specify a Windows user account, include the domain name in uppercase letters and use a single backslash (DOMAIN_NAME\user_name) in a Windows command line or a double backslash (DOMAIN_NAME\\user_name) in a UNIX command line.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

-w

Prints user and user group pending job thresholds and exits.

Output

A listing of the users and user groups is displayed with the following fields:

USER/GROUP

The name of the user or user group.

JL/P

The maximum number of job slots that can be processed simultaneously for the specified users on each processor. For non-preemptive scheduling, these job slots are used by running and suspended jobs or by pending jobs that have jobs slots reserved for them. For preemptive scheduling, these job slots are used by running jobs or by pending jobs that have slots reserved for them. This job limit is configured per processor so that multiprocessor hosts have more job slots. If the dash character (-) is displayed, there is no limit. JL/P is defined in the LSF configuration file lsb.users.

MAX

The maximum number of job slots that can be processed concurrently for the specified users’ jobs. For non-preemptive scheduling, these job slots are used by running and suspended jobs or by pending jobs that have job slots reserved for them. For preemptive scheduling, these job slots are used by running jobs or by pending jobs that have job slots reserved for them. If the character ‘–’ is displayed, there is no limit. MAX is defined by the MAX_JOBS parameter in the configuration file lsb.users(5).

NJOBS

The current number of job slots used by specified users’ jobs. A parallel job that is pending is counted as n job slots for it uses n job slots in the queue when it is dispatched.

PEND

The number of pending job slots used by jobs of the specified users.

RUN

The number of job slots used by running jobs of the specified users.

SSUSP

The number of job slots used by the system-suspended jobs of the specified users.

USUSP

The number of job slots used by user-suspended jobs of the specified users.

RSV

The number of job slots used by pending jobs of the specified users that have job slots reserved for them.

MPEND

The pending job threshold for the specified users or user groups. MPEND is defined by the MAX_PEND_JOBS parameter in the configuration file lsb.users.

See also

bugroup, lsb.users, lsb.queues