blimits

displays information about resource allocation limits of running jobs

Synopsis

blimits [-w] [-n limit_name ...] [-m host_name | -m host_group | -m cluster_name ...] [-P project_name ...] [-Lp license_project ...] [-q queue_name ...] [-u user_name | -u user_group ...]
blimits -c [-n limit_name ...]
blimits -h | -V

Description

Displays current usage of resource allocation limits configured in Limit sections in lsb.resources:
  • Configured limit policy name

  • Users (-u option)

  • Queues (-q option)

  • Hosts (-m option)

  • Project names (-P option)

  • License project names (-Lp option)

  • Limits (SLOTS, MEM, TMP, SWP, JOBS)

  • Limit configuration (-c option). This is the same as bresources with no options.

Resources that have no configured limits or no limit usage are indicated by a dash (-). Limits are displayed in a USED/LIMIT format. For example, if a limit of 10 slots is configured and 3 slots are in use, then blimits displays the limit for SLOTS as 3/10.

Note that if there are no jobs running against resource allocation limits, LSF indicates that there is no information to be displayed:

No resource usage found.

If limits MEM, SWP, or TMP are configured as percentages, both the limit and the amount used are displayed in MB. For example, lshosts displays maxmem of 249 MB, and MEM is limited to 10% of available memory. If 10 MB out of 25 MB are used, blimits displays the limit for MEM as 10/25 (10 MB USED from a 25 MB LIMIT).

Limits are displayed for both the vertical tabular format and the horizontal format for Limit sections. If a vertical format Limit section has no name, blimits displays NONAMEnnn under the NAME column for these limits, where the unnamed limits are numbered in the order the vertical-format Limit sections appear in the lsb.resources file.

If a resource consumer is configured as all, the limit usage for that consumer is indicated by a dash (-)

PER_HOST slot limits are not displayed. The bhosts commands displays these as MAX limits.

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

In MultiCluster, blimits returns the information about all limits in the local cluster.

Limit names and policies are set up by the LSF administrator. See lsb.resources(5) for more information.

Options

-c

Displays all resource configurations in lsb.resources. This is the same as bresources with no options.

-w

Displays resource allocation limits information in a wide format. Fields are displayed without truncation.

-n limit_name ...

Displays resource allocation limits the specified named Limit sections. If a list of limit sections is specified, Limit section names must be separated by spaces and enclosed in quotation marks (") or (’).

-m host_name | -m host_group | -m cluster_name ...

Displays resource allocation limits for the specified hosts. Do not use quotes when specifying multiple hosts.

To see the available hosts, use bhosts.

For host groups:

  • If the limits are configured with HOSTS, the name of the host group is displayed.

  • If the limits are configured with PER_HOST, the names of the hosts belonging to the group are displayed instead of the name of the host group.

Tip:

PER_HOST slot limits are not displayed. The bhosts command displays these as MXJ limits.

For a list of host groups see bmgroup(1).

In MultiCluster, if a cluster name is specified, displays resource allocation limits in the specified cluster.

-P project_name ...

Displays resource allocation limits for the specified projects.

If a list of projects is specified, project names must be separated by spaces and enclosed in quotation marks (") or (’).

-Lp project_name ...

Displays resource allocation limits for the specified license projects.

If a list of license projects is specified, license project names must be separated by spaces and enclosed in quotation marks (") or (’).

-q queue_name ...

Displays resource allocation limits for the specified queues.

The command bqueues returns a list of queues configured in the system, and information about the configurations of these queues.

In MultiCluster, you cannot specify remote queues.

-u user_name | -u user_group ...

Displays resource allocation limits for the specified users.

If a list of users is specified, user names must be separated by spaces and enclosed in quotation marks (") or (’). You can specify both user names and user IDs in the list of users.

If a user group is specified, displays the resource allocation limits that include that group in their configuration. For a list of user groups see bugroup(1)).

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Output

Configured limits and resource usage for built-in resources (slots, mem, tmp, and swp load indices, and running and suspended job limits) are displayed as INTERNAL RESOURCE LIMITS separately from custom external resources, which are shown as EXTERNAL RESOURCE LIMITS.

Output: Resource Consumers

blimits displays the following fields for resource consumers:

NAME

The name of the limit policy as specified by the Limit section NAME parameter.

USERS

List of user names or user groups on which the displayed limits are enforced, as specified by the Limit section parameters USERS or PER_USER.

User group names have a slash (/) added at the end of the group name. See bugroup(1).

QUEUES

The name of the queue to which the limits apply, as specified by the Limit section parameters QUEUES or PER_QUEUES.

If the queue has been removed from the configuration, the queue name is displayed as lost_and_found. Use bhist to get the original queue name. Jobs in the lost_and_found queue remain pending until they are switched with the bswitch command into another queue.

In a MultiCluster resource leasing environment, jobs scheduled by the consumer cluster display the remote queue name in the format queue_name@cluster_name. By default, this field truncates at 10 characters, so you might not see the cluster name unless you use -w or -l.

HOSTS

List of hosts and host groups on which the displayed limits are enforced, as specified by the Limit section parameters HOSTS or PER_HOSTS.

Host group names have a slash (/) added at the end of the group name. See bmgroup(1).

Tip:

PER_HOST slot limits are not displayed. The bhosts command displays these as MXJ limits.

PROJECTS

List of project names on which limits are enforced, as specified by the Limit section parameters PROJECTS or PER_PROJECT.

LIC_PROJECTS

List of license project names on which limits are enforced, as specified by the Limit section parameters LIC_PROJECTS or PER_LIC_PROJECT.

Output: Resource Limits

blimits displays resource allocation limits for the following resources:

SLOTS

Number of slots currently used and maximum number of slots configured for the limit policy, as specified by the Limit section SLOTS parameter.

MEM

Amount of memory currently used and maximum configured for the limit policy, as specified by the Limit section MEM parameter.

TMP

Amount of tmp space currently used and maximum amount of tmp space configured for the limit policy, as specified by the Limit section TMP parameter.

SWP

Amount of swap space currently used and maximum amount of swap space configured for the limit policy, as specified by the Limit section SWP parameter.

JOBS

Number of currently running and suspended jobs and the maximum number of jobs configured for the limit policy, as specified by the Limit section JOBS parameter.

Example

The following command displays limit configuration and dynamic usage information for project proj1:

blimits -P proj1
INTERNAL RESOURCE LIMITS:
NAME      USERS      QUEUES HOSTS PROJECTS    SLOTS   MEM    TMP   SWP   JOBS
limit1    user1         -   hostA proj1       2/6     -      -     -      -
NONAME022    -          -   hostB proj1 proj2 1/3     -      -     -      -
EXTERNAL RESOURCE LIMITS:
NAME      USERS      QUEUES     HOSTS     PROJECTS tmp1
limit1    user1         -       hostA     proj1    1/1

The following command displays limit configuration and dynamic usage information, including license project information (LIC_PROJECTS column).

blimits -Lp all
INTERNAL RESOURCE LIMITS:
NAME      USERS      QUEUES HOSTS PROJECTS    LIC_PROJECTS SLOTS   MEM    TMP   SWP   JOBS
limit1    -          -      -     -            p1 p2        -      0/200   -    0/100 1/5
limit2    -          -      -     -            -            1/8    -       -    -     -
 
EXTERNAL RESOURCE LIMITS:
NAME      USERS      QUEUES     HOSTS     PROJECTS   LIC_PROJECTS f1  f2
limit1    user1      -          hostA     proj1      -            1/1 -
limit4    -          -          -         -          all          -   1/1

See also

bclusters, bhosts, bhist, bmgroup, bqueues, bugroup, lsb.resources