File: sge_gdi_host_scaling.html

package info (click to toggle)
gridengine 6.2-4
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 51,532 kB
  • ctags: 51,172
  • sloc: ansic: 418,155; java: 37,080; sh: 22,593; jsp: 7,699; makefile: 5,292; csh: 4,244; xml: 2,901; cpp: 2,086; perl: 1,895; tcl: 1,188; lisp: 669; ruby: 642; yacc: 393; lex: 266
file content (168 lines) | stat: -rw-r--r-- 5,187 bytes parent folder | download | duplicates (21)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
     sge_gdi_host_attribute, sge_gdi_host_scaling,
     sge_gdi_host_nslots, sge_gdi_myhost_attribute,
     sge_gdi_myhost_scaling, sge_gdi_myhost_nslots
     - Grid Engine/TRM GDI calls

SYNOPSIS
     #include "sge_gdi_attributes.h"

     char *sge_gdi_host_attribute(
          char *hostname,
          char *attr_name
     );

     double sge_gdi_host_scaling(
          char *hostname,
          char *attr_name
     );

     int sge_gdi_host_nslots(
          char *hostname,
          u_long32 jobid
     );

     char *sge_gdi_myhost_attribute(
          char *attr_name
     );

     double sge_gdi_myhost_scaling(
          char *attr_name
     );

     int sge_gdi_myhost_nslots(
          u_long32 jobid
     );

DESCRIPTION
     The Transparent Resource Manager (TRM) extension to the Grid
     Engine  Database  Interface  (GDI) of Grid Engine simplifies
     integration of (parallel)  applications  with  Grid  Engine.
     Access  is  provided to information which describes the run-
     time environment of a Grid Engine job.  In many  cases  this
     information   can   be   used   to   optimize   runtime   of
     jobs/applications  by  adapting  its  behavior  to   runtime
     environment or load situation.

     The following is a description of the basic functionality of
     all Grid Engine TRM GDI functions:

  sge_gdi_host_attribute
     Returns value  of  the  requested  attribute  at  the  host.
     Depending  on  the  attribute  this  can  be a load value, a
     statically configured value or  a  consumable  resource.  On
     error  NULL  is  returned.  Otherwise  a pointer is returned
     which  points  to  a  static  address.  Please   note   that
     <I>sge</I>_<I>gdi</I>_<I>host</I>_<I>attribute</I>  will fail if the Grid Engine GDI was
     not successfully initialized by use of <B><A HREF="../htmlman3/sge_gdi_setup.html">sge_gdi_setup(3)</A></B>.

  sge_gdi_host_scaling
     Returns the scaling factor which is used to scale the  given
     load  value from the host. The scaling values for a host can
     be modified using the <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B> command.  If  no  scaling  is
     active for the attribute a value of 1 is returned.  On error
     -1 is returned. Please note that  <I>sge</I>_<I>gdi</I>_<I>host</I>_<I>scaling</I>  will
     fail if the Grid Engine GDI was not successfully initialized
     by use of <B><A HREF="../htmlman3/sge_gdi_setup.html">sge_gdi_setup(3)</A></B>.

  sge_gdi_host_nslots
     Returns the number of slots the job got from the Grid Engine
     scheduler  for  the given host. This number can be important
     in case of  multithreaded  parallel  applications.   If  the
     jobid  is  0  the  value  of  the JOB_ID environment is used
     instead.   On  error  0  is  returned.  Please   note   that
     <I>sge</I>_<I>gdi</I>_<I>host</I>_<I>nslots</I> will fail if the Grid Engine GDI was not
     successfully initialized by use of <B><A HREF="../htmlman3/sge_gdi_setup.html">sge_gdi_setup(3)</A></B>.

  sge_gdi_myhost_attribute
     Returns the value of the requested attribute  at  the  local
     host.   Depending on the attribute this can be a load value,
     a statically configured value or a consumable  resource.  On
     error  NULL  is  returned.  Otherwise  a pointer is returned
     which points to  a  static  address.  <I>sge</I>_<I>gdi</I>_<I>host</I>_<I>attribute</I>
     should  be  called  without  setting  up the Grid Engine GDI
     since this is done inside of this function.

  sge_gdi_myhost_scaling
     Returns the scaling factor which is used to scale the  given
     load  value  from  the  local host. The scaling values for a
     host can be modified using the <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B> command. If no scal-
     ing  is  active  for the attribute a value of 1 is returned.
     On error -1 is returned.  <I>sge</I>_<I>gdi</I>_<I>myhost</I>_<I>scaling</I>  should  be
     called  without setting up the Grid Engine GDI since this is
     done inside of this function.

  sge_gdi_myhost_nslots
     Returns the number of slots the job got from the Grid Engine
     scheduler  for  the local host. This number can be important
     in case of  multithreaded  parallel  applications.   If  the
     jobid  is  0  the  value  of  the JOB_ID environment is used
     instead.  On  error  0  is  returned.  <I>sge</I>_<I>gdi</I>_<I>myhost</I>_<I>nslots</I>
     should  be  called  without  setting  up the Grid Engine GDI
     since this is done inside of this function.


SEE ALSO
     <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>, <B><A HREF="../htmlman3/sge_gdi_setup.html">sge_gdi_setup(3)</A></B>.  <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>

COPYRIGHT
     See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and  permis-
     sions.














































</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>