bresources
Displays information about resource reservation, resource limits, and guaranteed resource policies.
Synopsis
bresources -s [resource_name ...]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.