...
- Change Control: Public/Stable
- Permissions: The job_sort_formula must be set by the admin (e.g., root).
- Summary: A number between 0 and 1 representing the job's entities usage modified to take it's location in the fairshare tree into account.
- Details:
- A number between 0 and 1. Higher numbers are less deserving.
- This number is somewhat arbitrary. It's based on the actual usage of the entity and its location in the fairshare tree, but isn't directly comparable with any other entity's fairshare_tree_usage.
- The below formula refers to this keyword as effective usage.
- NOTE: the formula is calculated once at the start of the cycle. This factor will not be updated during the cycle (e.g., after jobs run).
...
- Change Control: Public/Stable
- Permissions: The job_sort_formula must be set by the admin (e.g., root)
- Summary: Number that allows two entities to be directly compared
- Details:
- A number between 0 and 1. Lower numbers are less deserving
- This number allows two entities anywhere in the tree hierarchy to be compared.
- Low usage entities from high usage groups are negatively affected by their siblings.
- If any job's entity has 0 shares, this keyword will resolve to 0.
- See below for calculations
...
Something to note: summing all of the effective usages of all of the entities will be more than 100%. This doesn't allow for direct comparison between the entities.
The effective usage keyword in the formula is 'fairshare_tree_usage'
Here is a formula to provide a direct comparison between entities. It is not the only one, but it will work well. It results in a number between 0 and 1. A result of .5 means the entity is on fairshare_perctarget.
2^-(fairshare_tree_usage / entity's fairshare_perc)
...
There is extra quoting which is required to use formula math. Here is how it is done: qmgr -c 'set server job_sort_formula="pow(2, -(fairshare_tree_usage/fairshare_perc))"'
Please note that this formula divides by fairshare_perc. If an entity's shares is set to 0, this will cause a division by zero error. Please take care when using this formula.
Example:
Share numbers do not need to add up to 100, it just makes the example easier to understand. Entities don't need to all be at the same level of the tree. For example, root could own an entity.
...