Platform LSF Reference Version 6.2

lsb.queues
Platform LSF Reference
405
The number of shares assigned to each user is only meaningful when you compare
it to the shares assigned to other users or to the total number of shares. The total
number of shares is just the sum of all the shares assigned in each share assignment.
Compatibility
Do not configure hosts in a cluster to use fairshare at both queue and host levels.
However, you can configure user-based fairshare and queue-based fairshare together.
Default
Undefined (no fairshare)
FAIRSHARE_QUEUES
Syntax
FAIRSHARE_QUEUES=
queue_name queue_name ...
Description
Defines cross-queue fairshare.
When this parameter is defined:
◆ The queue in which this parameter is defined becomes the “master queue”.
◆ Queues listed with this parameter are “slave queues” and inherit the fairshare policy
of the master queue.
◆ A user has the same priority across the master and slave queues.
If the same user submits several jobs to these queues, user priority is calculated by
taking into account all the jobs the user has submitted across the master-slave set.
Notes
◆ By default, the PRIORITY range defined for queues in cross-queue fairshare cannot
be used with any other queues. For example, you have 4 queues: queue1, queue2,
queue3,
queue4. You configure cross-queue fairshare for queue1, queue2, queue3
and assign priorities of 30, 40, 50 respectively.
◆ By default, the priority of queue4 (which is not part of the cross-queue fairshare)
cannot fall between the priority range of the cross-queue fairshare queues (30-50).
It can be any number up to 29 or higher than 50. It does not matter if
queue4 is a
fairshare queue or FCFS queue.
If DISPATCH_ORDER=QUEUE is set in the master queue, the priority of
queue4 (which is not part of the cross-queue fairshare) can be any number,
including a priority falling between the priority range of the cross-queue fairshare
queues (30-50).
◆ FAIRSHARE must be defined in the master queue. If it is also defined in the queues
listed in FAIRSHARE_QUEUES, it will be ignored.
◆ Cross-queue fairshare can be defined more than once within lsb.queues. You
can define several sets of master-slave queues. However, a queue cannot belong to
more than one master-slave set. For example, you can define:
❖ In queue normal: FAIRSHARE_QUEUES=short license
❖ In queue priority: FAIRSHARE_QUEUES=night owners
You cannot, however, define night, owners, or priority as slaves in the queue
normal; or normal, short and license as slaves in the priority queue; or
short, license, night, owners as master queues of their own.
◆ Cross-queue fairshare cannot be used with host partition fairshare. It is part of
queue-level fairshare.
Default
Undefined