bresources

Displays information about resource reservation, resource limits, and guaranteed resource policies.

Synopsis

bresources -s [resource_name ...]
bresources -g [-l [-q queue_name] [-m]] [guaranteed_resource_pool_name ...]
bresources [-h | -V]
bresources -p

Description

By default, the bresources command displays all resource limit configurations in the lsb.resources file. The default bresources command output is the same as the blimits -c command.

Options

-s
Displays per-resource reservation configurations from the ReservationUsage section of lsb.resources.
resource_name ...
Used with -s, displays reservation configurations about the specified resource.
-g
Displays the configuration and status of the guaranteed resource pool that is configured in the GuaranteedResourcePool section of lsb.resources. The following information about each guaranteed resource pool is displayed: name, type, status, available resources, unused resources, total configured resource guarantees, and number of guaranteed resources currently unused.

The -g option also displays the number of resources that are loaned for the guaranteed resource pool, and the -q option cannot be specified with -g, unless the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.

-l
With -g, displays configuration and status information of the guaranteed resource pool that is configured in the GuaranteedResourcePool section of lsb.resources in a long multiline format. The -l option displays the following information:
  • Description
  • Distribution of guarantees among service classes
  • Special policies
  • Configured hosts list
  • Static resource requirement select string
  • Administrator
  • The following information for each guarantee that is made from the resource pool:
    • Name
    • Resources guaranteed
    • Resources in use
-m
With -g and -l, displays the names of all hosts included in each guaranteed resource pool configuration from the GuaranteedResourcePool section of the lsb.resources file.
-q
Helps you understand how the guarantee policy works when combined with queue-based preemption. Administrators can determine the number of guarantee resources available through preemption to a preemptive queue. The -q option takes effect only for package pools. When the -q option is specified with a name of a preemptive queue, the values that are displayed are shown about the specified queue.
Note: The -q option does not work with the -g option unless the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.
resource_pool ...
Displays information about the specified resource pool.
-h
Prints command usage to stderr and exits.
-V
Prints LSF release version to stderr and exits.
-p
Displays the currently defined energy aware scheduling policies and exits. Shows the PowerPolicy settings as they are in the lsb.resources file. An extra line is included with the PowerPolicy settings to indicate whether the policy is applied (Y) or not (N).

Guaranteed resource pool output (-g)

POOL_NAME
Configured name of the guaranteed resource pool.
TYPE
Configured type of guaranteed resource pool. The pool can include the following resources:
  • hosts
  • slots
  • packages, where each unit guaranteed is composed of a number of slots, and some amount of memory together on the same host.
  • resources that are managed by LSF License Scheduler.
STATUS
The following values are displayed:
  • ok
  • unknown
  • overcommitted, where total resources in the pool are less than the number guaranteed. The guarantee commitments cannot all be met concurrently.
  • close_loans, where lending is suspended due to pending demand.

    This state occurs only when the CLOSE_ON_DEMAND [parameter is set in the LOAN_POLICIES section, and at least one job with a guarantee in the pool is not using all of its configured guarantee.

TOTAL
Number of resources that are included in the guaranteed resource pool.
FREE
Number of unused resources within the guaranteed resource pool.
ALLOCATED
The amount of the resource that is reserved for the service classes of the pool. For package pools, this field is further divided into allocated memory and allocated slots.

This field is hidden if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.

OWNER USE
The total amount of the resource that is currently in use by the service classes on owned hosts of the pool. For package pools, this field is further divided into used memory and used slots by the consumers (service classes) of the pool.

This field is hidden if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.

GUARANTEE CONFIGURED
Configured number of guaranteed resources, if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.
GUARANTEE USED
Number of guarantees that are used, if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.

Long output (-gl)

In addition to the fields included in the guaranteed resource pool output (-g option), the long output includes the following fields.

GUARANTEED RESOURCE POOL
Name and description of guaranteed resource pool.
DISTRIBUTION
Configured distribution of guarantees among service classes.
LOAN_POLICIES
Configured policies.
HOSTS
Configured hosts list.
OWNER USE
The total amount of the resource that is used by jobs on owned hosts of the pool.

In the output table that is organized by owner, this is the total amount of the resource that is currently in use by the service classes on owned hosts of the pool.

In the output table that is organized by host, this is the total amount of the resources that is currently in use on the host by owner jobs.

For package pools, this field is further divided into used memory and used slots by the consumers (service classes) of the pool.

This field is hidden if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.

LOAN USE
The amount of the resources that are used by service class jobs that are started through loaning. This field is hidden if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.
OTHER USE
The amount of the resources that are used by other jobs that are running on shared hosts and are not owner or loaning jobs.

In the output table that is organized by owner, this field is the amount of the resources that are used by jobs of the service class on shared hosts in the guarantee shared pool (that is, hosts that are marked as "-"). This usage does not count towards the owner's guarantee limits.

In the output table that is organized by host, this field is the amount of the resources that are used on the host by other jobs that are not owner or loaning jobs.

This field is hidden if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.

CONSUMERS
Service classes with guarantees in the pool, if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.
GUARANTEE CONFIGURED
Number of resources in the pool that are guaranteed to the service class, if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.
GUARANTEE USED
Number of resources currently in use by the service class to meet the guarantee. After the guarantee is met, other jobs from the service class that run in the resource pool do not count towards the guarantee, and are not included. Resource use includes both running and suspended jobs, if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.
TOTAL USED
Total number of resources that are used in the pool by the service class. Resource use includes both running and suspended jobs, if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.
ADMINISTRATORS
Configured administrators that can manage the corresponding guaranteed resource pool, if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.

Long output with hosts (-glm)

In addition to fields included in the long output (option -gl), hosts currently in the resource pool are listed.

HOST
Name of the host.
RESERVED
Host reservation status:
  • Y: The host is reserved for owners only.
  • Y*: The host is reserved for owners only and loaning is disabled on the host.
  • -: The host is not reserved and may be used by any job.
RESOURCE
Indicates the resource name (that is, slots or mem), or packages.

These fields are hidden if the SIMPLIFIED_GUARANTEE parameter in the lsb.params file is disabled (that is, set to N or n) or is not defined.