1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
4
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
6
<META NAME="GENERATOR" CONTENT="StarOffice/5.2 (Solaris Sparc)">
7
<META NAME="AUTHOR" CONTENT=" ">
8
<META NAME="CREATED" CONTENT="20010611;14564800">
9
<META NAME="CHANGEDBY" CONTENT=" ">
10
<META NAME="CHANGED" CONTENT="20010716;16471800">
13
<H1><FONT SIZE=6 STYLE="font-size: 28pt">Scheduling Library</FONT></H1>
15
<P>This library contains important high- and low-level functions
16
mainly used by Schedd, some of the functions contained herein however
17
have been proven to be used as well by clients like qstat, qhost or
18
qmon, but also by qmaster. For a comprehensive functional
19
segmentation of the schedulers source code refer to the <A HREF="../../daemons/schedd/schedd.html">schedd
20
documentation</A>.</P>
21
<H1>Reusable low-level building blocks</H1>
22
<P>The scheduling library contains some functions that can be reused.
23
Here is a description about their semantics:</P>
25
<LI><P>host list sorting</P>
26
<P>Function <I>sort_host_list() </I><SPAN STYLE="font-style: normal">sorts
27
the host list according to the load_formula (see manual page
28
sched_conf(5)). It takes into account the adjusted load situation
29
(see under 'job_load_adjustments' and 'load_adjustment_decay_time'
30
in sched_conf(5)) and the availability of consumable resources (see
31
under 'consumable' in complex(5)).</SPAN></P>
32
<LI><P STYLE="font-style: normal">check whether a queue is in
33
load/suspend alarm</P>
34
<P STYLE="font-style: normal">This is implemented in
35
<I>sge_load_alarm(). </I>The function takes into account the
36
adjusted load situation (see under 'job_load_adjustments' and
37
'load_adjustment_decay_time' in sched_conf(5)).</P>
38
<LI><P ALIGN=LEFT>verification whether a job matches a queue</P>
39
<P ALIGN=LEFT>This operation is implemented in
40
<I>sge_why_not_job2queue_static()</I><SPAN STYLE="font-style: normal">.
41
Please note that the purpose of this function is just to answer the
42
question whether a job in principle can be dispatched to a queue.
43
The pertinent conditions are things like access permissions, job
44
type or required resources, but it does not take into account
45
dynamically changing properties like current load situation or
46
availability of consumables.</SPAN></P>
47
<LI><P ALIGN=LEFT>verification whether a job matches a host</P>
48
<P ALIGN=LEFT STYLE="font-style: normal">This operation is
49
implemented in <I>sge_why_not_job2host()</I>. This can be seen as
50
the counter-part of <I>sge_why_not_job2queue_static() </I>checking
51
for suitable hosts instead of queues and the same restrictions
54
<P ALIGN=CENTER STYLE="text-decoration: none">Copyright 2001 Sun
55
Microsystems, Inc. All rights reserved.</P>