1 karl 1.1 <html xmlns:o="urn:schemas-microsoft-com:office:office"
2 xmlns:w="urn:schemas-microsoft-com:office:word"
3 xmlns="http://www.w3.org/TR/REC-html40">
4
5 <head>
6 <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
7 <meta name=ProgId content=Word.Document>
8 <meta name=Generator content="Microsoft Word 9">
9 <meta name=Originator content="Microsoft Word 9">
10 <link rel=File-List
11 href="./CompilerExtensionstoSupportProviderRegistration_files/filelist.xml">
12 <title>Pegasus Project Working Paper</title>
13 <!--[if gte mso 9]><xml>
14 <o:DocumentProperties>
15 <o:Author>Karl</o:Author>
16 <o:Template>Pegasus Project Working Paper.dot</o:Template>
17 <o:LastAuthor>Karl</o:LastAuthor>
18 <o:Revision>8</o:Revision>
19 <o:TotalTime>141</o:TotalTime>
20 <o:LastPrinted>2002-02-22T16:51:00Z</o:LastPrinted>
21 <o:Created>2002-02-22T16:20:00Z</o:Created>
22 karl 1.1 <o:LastSaved>2002-02-22T16:54:00Z</o:LastSaved>
23 <o:Pages>3</o:Pages>
24 <o:Words>1283</o:Words>
25 <o:Characters>7316</o:Characters>
26 <o:Company>Inova</o:Company>
27 <o:Lines>60</o:Lines>
28 <o:Paragraphs>14</o:Paragraphs>
29 <o:CharactersWithSpaces>8984</o:CharactersWithSpaces>
30 <o:Version>9.4402</o:Version>
31 </o:DocumentProperties>
32 </xml><![endif]--><!--[if gte mso 9]><xml>
33 <w:WordDocument>
34 <w:Zoom>75</w:Zoom>
35 <w:AttachedTemplate HRef="Pegasus Project Working Paper.dot"></w:AttachedTemplate>
36 </w:WordDocument>
37 </xml><![endif]-->
38 <style>
39 <!--
40 /* Style Definitions */
41 p.MsoNormal, li.MsoNormal, div.MsoNormal
42 {mso-style-parent:"";
43 karl 1.1 margin:0in;
44 margin-bottom:.0001pt;
45 mso-pagination:widow-orphan;
46 font-size:12.0pt;
47 font-family:"Times New Roman";
48 mso-fareast-font-family:"Times New Roman";}
49 h1
50 {mso-style-next:Normal;
51 margin-top:12.0pt;
52 margin-right:0in;
53 margin-bottom:3.0pt;
54 margin-left:0in;
55 mso-pagination:widow-orphan;
56 page-break-after:avoid;
57 mso-outline-level:1;
58 font-size:16.0pt;
59 font-family:Arial;
60 mso-font-kerning:16.0pt;}
61 h2
62 {mso-style-next:Normal;
63 margin:0in;
64 karl 1.1 margin-bottom:.0001pt;
65 mso-pagination:widow-orphan;
66 page-break-after:avoid;
67 mso-outline-level:2;
68 font-size:12.0pt;
69 mso-bidi-font-size:10.0pt;
70 font-family:"Courier New";}
71 p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
72 {margin:0in;
73 margin-bottom:.0001pt;
74 mso-pagination:widow-orphan;
75 font-size:10.0pt;
76 font-family:"Courier New";
77 mso-fareast-font-family:"Times New Roman";}
78 p.PaperTitle, li.PaperTitle, div.PaperTitle
79 {mso-style-name:PaperTitle;
80 margin:0in;
81 margin-bottom:.0001pt;
82 text-align:center;
83 mso-pagination:widow-orphan;
84 font-size:24.0pt;
85 karl 1.1 mso-bidi-font-size:12.0pt;
86 font-family:"Times New Roman";
87 mso-fareast-font-family:"Times New Roman";
88 font-weight:bold;
89 mso-bidi-font-weight:normal;}
90 @page Section1
91 {size:8.5in 11.0in;
92 margin:1.0in 1.25in 1.0in 1.25in;
93 mso-header-margin:.5in;
94 mso-footer-margin:.5in;
95 mso-paper-source:0;}
96 div.Section1
97 {page:Section1;}
98 /* List Definitions */
99 @list l0
100 {mso-list-id:8916730;
101 mso-list-type:hybrid;
102 mso-list-template-ids:1862858776 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
103 @list l1
104 {mso-list-id:813445812;
105 mso-list-type:hybrid;
106 karl 1.1 mso-list-template-ids:1400267148 67698703 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
107 @list l2
108 {mso-list-id:836923935;
109 mso-list-type:hybrid;
110 mso-list-template-ids:-1555669326 67698689 1935563580 1644480232 1693206816 -962706662 -934745516 528001178 -1798818850 764575260;}
111 @list l2:level1
112 {mso-level-number-format:bullet;
113 mso-level-text:\F0B7;
114 mso-level-tab-stop:.5in;
115 mso-level-number-position:left;
116 text-indent:-.25in;
117 font-family:Symbol;}
118 @list l3
119 {mso-list-id:1391613595;
120 mso-list-type:hybrid;
121 mso-list-template-ids:-2027158932 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
122 @list l3:level1
123 {mso-level-number-format:bullet;
124 mso-level-text:\F0B7;
125 mso-level-tab-stop:.5in;
126 mso-level-number-position:left;
127 karl 1.1 text-indent:-.25in;
128 font-family:Symbol;}
129 @list l4
130 {mso-list-id:1412967939;
131 mso-list-type:hybrid;
132 mso-list-template-ids:-1458692366 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
133 @list l4:level1
134 {mso-level-number-format:bullet;
135 mso-level-text:\F0B7;
136 mso-level-tab-stop:.5in;
137 mso-level-number-position:left;
138 text-indent:-.25in;
139 font-family:Symbol;}
140 @list l5
141 {mso-list-id:1654481399;
142 mso-list-type:hybrid;
143 mso-list-template-ids:-2096598596 67698689 1440661024 -2121751836 1891401522 746083054 -538574160 -1957930924 -343529822 -1785850398;}
144 @list l5:level1
145 {mso-level-number-format:bullet;
146 mso-level-text:\F0B7;
147 mso-level-tab-stop:.5in;
148 karl 1.1 mso-level-number-position:left;
149 text-indent:-.25in;
150 font-family:Symbol;}
151 @list l6
152 {mso-list-id:1689333165;
153 mso-list-type:hybrid;
154 mso-list-template-ids:-263048826 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
155 @list l6:level1
156 {mso-level-number-format:bullet;
157 mso-level-text:\F0B7;
158 mso-level-tab-stop:.5in;
159 mso-level-number-position:left;
160 text-indent:-.25in;
161 font-family:Symbol;}
162 @list l7
163 {mso-list-id:1721858141;
164 mso-list-type:hybrid;
165 mso-list-template-ids:-2000788846 67698689 1643545156 -559619832 -2132085430 -550596614 379464750 879668152 1047431978 1261200574;}
166 @list l7:level1
167 {mso-level-number-format:bullet;
168 mso-level-text:\F0B7;
169 karl 1.1 mso-level-tab-stop:.5in;
170 mso-level-number-position:left;
171 text-indent:-.25in;
172 font-family:Symbol;}
173 ol
174 {margin-bottom:0in;}
175 ul
176 {margin-bottom:0in;}
177 -->
178 </style>
179 </head>
180
181 <body lang=EN-US style='tab-interval:.5in'>
182
183 <div class=Section1>
184
185 <p class=PaperTitle>Pegasus Project Working Paper</p>
186
187 <p class=PaperTitle>Compiler Extensions to Support Provider Registration</p>
188
189 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
190 karl 1.1
191 <p class=MsoNormal><b>Authors:</b> Denise Eckstein, Karl Schopmeyer</p>
192
193 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
194
195 <p class=MsoNormal><span style='font-size:8.0pt;mso-bidi-font-size:12.0pt'>Last
196 Update <span style='mso-field-code:"SAVEDATE \\* MERGEFORMAT"'>2/22/2002 10:31
197 AM</span><o:p></o:p></span></p>
198
199 <p class=MsoNormal><span style='font-size:8.0pt;mso-bidi-font-size:12.0pt'>Document:
200 <span style='mso-field-code:"FILENAME \\* MERGEFORMAT"'>CompilerExtensionstoSupportProviderRegistration.htm</span><o:p></o:p></span></p>
201
202 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
203
204 <p class=MsoNormal>Revision Status</p>
205
206 <table border=1 cellspacing=0 cellpadding=0 style='border-collapse:collapse;
207 border:none;mso-border-alt:solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>
208 <tr>
209 <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
210 padding:0in 5.4pt 0in 5.4pt'>
211 karl 1.1 <p class=MsoNormal>0.1</p>
212 </td>
213 <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
214 border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
215 <p class=MsoNormal>KS</p>
216 </td>
217 <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
218 border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
219 <p class=MsoNormal>Draft for discussion</p>
220 </td>
221 <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
222 border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
223 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
224 </td>
225 </tr>
226 <tr>
227 <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
228 border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
229 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
230 </td>
231 <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
232 karl 1.1 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
233 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
234 padding:0in 5.4pt 0in 5.4pt'>
235 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
236 </td>
237 <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
238 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
239 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
240 padding:0in 5.4pt 0in 5.4pt'>
241 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
242 </td>
243 <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
244 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
245 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
246 padding:0in 5.4pt 0in 5.4pt'>
247 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
248 </td>
249 </tr>
250 <tr>
251 <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
252 border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
253 karl 1.1 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
254 </td>
255 <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
256 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
257 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
258 padding:0in 5.4pt 0in 5.4pt'>
259 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
260 </td>
261 <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
262 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
263 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
264 padding:0in 5.4pt 0in 5.4pt'>
265 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
266 </td>
267 <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
268 none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
269 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
270 padding:0in 5.4pt 0in 5.4pt'>
271 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
272 </td>
273 </tr>
274 karl 1.1 </table>
275
276 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
277
278 <h1>Introduction</h1>
279
280 <p class=MsoNormal>This document defines a set of extensions to the Pegasus Cim
281 Compiler to help with the process of registering providers using MOF and the
282 compiler as the registration tool.<span style="mso-spacerun: yes"> </span>The
283 additional functions are felt to be requirements to create an environment in
284 Pegasus Version 2 that is usable for provider installation and registration in
285 running Pegasus systems.</p>
286
287 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
288
289 <h1>Background</h1>
290
291 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>These
292 proposed extensions started with work done by HP to define some rules and
293 possible extensions to the system to help control the input of MOF for provider
294 registration.<o:p></o:p></span></p>
295 karl 1.1
296 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>We
297 have to assume that provider registration can be done at any time, not simply
298 at build of a new system and must be done when the cimom is running.<span
299 style="mso-spacerun: yes"> </span>Further, it is intended that this be done by
300 inputting MOF to the system.<o:p></o:p></span></p>
301
302 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
303 is one of the characteristics that drives us to create the version of the CIM
304 compiler that is driven from the client interface and can input when the CIMOM
305 is running.<o:p></o:p></span></p>
306
307 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Further
308 extensions revolve around:<o:p></o:p></span></p>
309
310 <ul style='margin-top:0in' type=disc>
311 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list .5in'><span
312 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>The
313 providers not necessarily knowing what is in the CIMOM when they create
314 their registration MOF.<o:p></o:p></span></li>
315 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list .5in'><span
316 karl 1.1 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Controlling
317 input to reduce the possibility that providers can input incorrect
318 versions of MOF.<o:p></o:p></span></li>
319 </ul>
320
321 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
322 set of extensions goes handin-hand with a set of changes that were just
323 approved by the DMTF:<o:p></o:p></span></p>
324
325 <ul style='margin-top:0in' type=disc>
326 <li class=MsoNormal style='mso-list:l4 level1 lfo6;tab-stops:list .5in'><span
327 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Mandatory
328 use of the Version Qualifier in the future, starting with the CIM 2.6
329 Final release scheduled for March 2002.<span style="mso-spacerun: yes">
330 </span>All classes in the CIM schema must have this qualifier which
331 defines the last CIM Schema version in which the class itself was modified
332 (ex. Version (2.6.0).<o:p></o:p></span></li>
333 </ul>
334
335 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>The
336 use of the Experimental Qualifier that identifies all classes that are
337 karl 1.1 considered experimental and not released.<span style="mso-spacerun: yes">
338 </span>Generally we should Never see the experimental qualifier on any classes
339 in a released version of the CIM MOF and should see it only on classes that
340 change or are added for a preliminary release.<span style="mso-spacerun: yes">
341 </span>All of these classes must be either moved to release or removed from the
342 Schema to allow a schema to move to release status within the DMTF.<span
343 style="mso-spacerun: yes"> </span></span><span style='mso-bidi-font-size:10.0pt;
344 font-family:Arial;mso-bidi-font-family:"Courier New"'>The String representing
345 the version MUST be in the form of: </span><span style='font-family:Arial;
346 mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
347
348 <h2><span style='font-family:Arial;mso-bidi-font-family:"Courier New"'><span
349 style="mso-spacerun: yes"> </span>M + "." + N + "." + U<o:p></o:p></span></h2>
350
351 <p class=MsoNormal style='margin-left:1.0in'><span style='mso-bidi-font-size:
352 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'><br>
353 <b>M - </b>The major version in numeric form in which the class was
354 changed. <br>
355 <b>N</b> - The minor version in numeric form in which the class was
356 changed. <br>
357 <b>U</b> - The update (e.g. errata, patch, ...) in numeric form in which the
358 karl 1.1 class was changed.</span><span style='font-size:10.0pt;font-family:Arial;
359 mso-bidi-font-family:"Courier New"'> </span><span style='font-family:Arial;
360 mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
361
362 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>More
363 information about these changes will be available from the DMTF when CIM
364 version 2.6 final is released.</span></p>
365
366 <h1>The Definition of Provider Guidelines</h1>
367
368 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
369
370 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>The
371 following guidelines for providers and provider writers help to understand
372 these requirements:<o:p></o:p></span></p>
373
374 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'> </span><br>
375 <span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
376 "Courier New"'>1.) Provider Developer's SHOULD include the definition of all
377 required superclasses in the MOF.</span><span style='font-family:Arial;
378 mso-bidi-font-family:"Times New Roman"'><br>
379 karl 1.1 </span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
380 "Courier New"'>2.) All class definitions MUST include a VERSION qualifier.</span><span
381 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><br>
382 </span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
383 "Courier New"'>3.) Use of the VERSION qualifier string MUST comply with the
384 DMTF guidelines. In particular, any change that breaks backward compatibility
385 MUST be labeled with a new MAJOR version number.</span><span style='font-family:
386 Arial;mso-bidi-font-family:"Times New Roman"'><br>
387 </span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
388 "Courier New"'>4.) All included class definitions MUST contain a complete and
389 accurate definition of the specified version of the class.</span><span
390 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><br>
391 </span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
392 "Courier New"'>5.) Provider Developer's SHOULD assume that DMTF qualifiers
393 (version 2.6) are already defined in the namespace.<o:p></o:p></span></p>
394
395 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
396 mso-bidi-font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
397
398 <p class=MsoBodyText><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
399 font-family:Arial;mso-bidi-font-family:"Courier New"'>This MOF Update Utility
400 karl 1.1 is a very simple tool that supports a majority of the provider installation
401 senarios. It handles the straight-forward upgrade
402 cases. Situations that require more sophisticated Schema
403 manipulation will require developers to write a
404 customize CIM Client application to perform the necessary checks and
405 schema modifications. E.g., a customized application could be developed
406 to perform a MAJOR version upgrade.<o:p></o:p></span></p>
407
408 <h1><span style='font-size:12.0pt;mso-bidi-font-size:16.0pt'>MOF Enhancements
409 to Support Provider Registration<o:p></o:p></span></h1>
410
411 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
412
413 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>General
414 changes<o:p></o:p></span></p>
415
416 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
417
418 <ol style='margin-top:0in' start=1 type=1>
419 <li class=MsoNormal style='mso-list:l0 level1 lfo9;tab-stops:list .5in'><span
420 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Extend
421 karl 1.1 the compiler to allow class replacement. Thus, the compiler would be able
422 to replace classes as well as install classes under circumstances defined
423 in this document<o:p></o:p></span></li>
424 <li class=MsoNormal style='mso-list:l0 level1 lfo9;tab-stops:list .5in'><span
425 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Extend
426 the compiler to allow use through the client interface.<span
427 style="mso-spacerun: yes"> </span>The proposed solution is to provide two
428 versions of the compiler.<span style="mso-spacerun: yes"> </span>One
429 would be used through the reposiotory interface (as is done today). The
430 second version would use the client interface and would be used only when
431 the CIMServer was running.<o:p></o:p></span></li>
432 </ol>
433
434 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
435
436 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
437
438 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Epecific
439 option additions<o:p></o:p></span></p>
440
441 <ol style='margin-top:0in' start=1 type=1>
442 karl 1.1 <li class=MsoNormal style='mso-list:l1 level1 lfo12;tab-stops:list .5in'><span
443 style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
444 "Courier New"'>Add a new parameter to the cimmof command line,
445 --experimental, to control handling of the experimental classes and
446 qualifiers.<o:p></o:p></span></li>
447 <li class=MsoNormal style='mso-list:l1 level1 lfo12;tab-stops:list .5in'><span
448 style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
449 "Courier New"'>Add a new parameter to the cimmof command line,
450 --version=X.X.X, to allow easy migration of existing MOF files to use
451 versioning.</span><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>
452 <o:p></o:p></span></li>
453 </ol>
454
455 <p class=MsoNormal><span style='font-size:10.0pt;font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
456
457 <h1><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>--Experimental
458 Option</span><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
459 font-family:"Courier New"'><o:p></o:p></span></h1>
460
461 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>NOTE:
462 References to the Minor version defined below also apply to the update
463 karl 1.1 parameter in the Version qualifier.<o:p></o:p></span></p>
464
465 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
466
467 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>The
468 --experimental parameter on the command line must be set to allow the CIMMOF to
469 replace an EXPERIMENTAL class definition with either an EXPERIMENTAL or
470 RELEASED class definition (in short to be replaced) if the modification is not
471 a MINOR version or REVISION update to the class. If the --
472 experimental parameter is not defined and any class in a MOF definition is
473 experimental, the entire MOF must be rejected (with no changes to the
474 repository) unless that new class definition represents a MINOR version update
475 or REVISION update as defined by the VERSION qualifier.<o:p></o:p></span></p>
476
477 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
478
479 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
480 option was originally defined as follows hopefully the definitions above and
481 below match):<o:p></o:p></span></p>
482
483 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
484 karl 1.1
485 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
486 mso-bidi-font-family:"Courier New"'>A MOF will be rejected if ...</span><span
487 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'> <o:p></o:p></span></p>
488
489 <ul type=disc>
490 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
491 mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
492 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
493 require replacing a class definition with a MAJOR version update. <o:p></o:p></span></li>
494 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
495 mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
496 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>If the
497 --experimental parameter IS NOT specified and it would require replacing
498 an EXPERIMENTAL class definition with either an updated EXPERIMENTAL class
499 definition or RELEASED class definition.<span style="mso-spacerun: yes">
500 </span>The justification is that replacing an EXPERIMENTAL with a RELEASED
501 or EXPERIMENTAL class could break other classes ... We wanted to make this
502 action explicit<o:p></o:p></span></li>
503 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
504 mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
505 karl 1.1 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
506 require replacing a RELEASED class definition with an EXPERIMENTAL class
507 definition. <o:p></o:p></span></li>
508 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
509 mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
510 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
511 require replacing a class with an earlier MAJOR version number. <o:p></o:p></span></li>
512 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
513 mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
514 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>If the
515 --version parameter IS NOT specified and a class definition does not
516 contain a VERSION qualifier.</span><span style='font-family:Arial;
517 mso-bidi-font-family:"Times New Roman"'> <o:p></o:p></span></li>
518 </ul>
519
520 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
521 mso-bidi-font-family:"Courier New"'>A class definition within a MOF will be
522 ignored if ...</span><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>
523 <o:p></o:p></span></p>
524
525 <ul type=disc>
526 karl 1.1 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
527 mso-list:l2 level1 lfo18;tab-stops:list .5in'><span style='mso-bidi-font-size:
528 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
529 result in replacing a class definition with one with an earlier MINOR
530 version number. </span><span style='font-family:Arial;mso-bidi-font-family:
531 "Times New Roman"'><o:p></o:p></span></li>
532 </ul>
533
534 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
535 mso-bidi-font-family:"Courier New"'>An existing class definition will be
536 replaced if ...</span><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>
537 <o:p></o:p></span></p>
538
539 <ul type=disc>
540 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
541 mso-list:l7 level1 lfo21;tab-stops:list .5in'><span style='mso-bidi-font-size:
542 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It represents
543 an MINOR version update. <o:p></o:p></span></li>
544 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
545 mso-list:l7 level1 lfo21;tab-stops:list .5in'><span style='mso-bidi-font-size:
546 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>If the
547 karl 1.1 --experimental parameter IS specified and it would require replacing an
548 EXPERIMENTAL class definition with either an updated EXPERIMENTAL class
549 definition or RELEASED class definition. </span><span style='font-family:
550 Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></li>
551 </ul>
552
553 <p class=MsoNormal><b><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>NOTE:</span></b><span
554 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'> Note the use
555 of the word ignored vs. rejected.<span style="mso-spacerun: yes"> </span>The
556 requirement is to reject the entire MOF file under certain circumstances.<o:p></o:p></span></p>
557
558 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
559 means that somehow the compiler must predetermine if there are any reasons for
560 rejecting the MOF BEFORE it puts any classes into the repository</span>.<span
561 style="mso-spacerun: yes"> </span>While this implies a multiplass compiler, we
562 hope that there is some way this can be creatively accomplished without major
563 changes to the compiler (ex. creating a super process that would simply call
564 the compiler with different options for the check phase).</p>
565
566 <p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
567
568 karl 1.1 <h1>--Version Option</h1>
569
570 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Variations
571 of his option can be use for two things:<o:p></o:p></span></p>
572
573 <ul style='margin-top:0in' type=disc>
574 <li class=MsoNormal style='mso-list:l6 level1 lfo24;tab-stops:list .5in'><span
575 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Force the
576 version qualifier to be put on each class.<o:p></o:p></span></li>
577 <li class=MsoNormal style='mso-list:l6 level1 lfo24;tab-stops:list .5in'><span
578 style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Test and
579 insure that the version qualifier is on each class and reject the input if
580 there is any class without the qualifier.<o:p></o:p></span></li>
581 </ul>
582
583 <p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>If
584 the options is present with the (x.x.x) </span><span style='mso-bidi-font-size:
585 10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>the cimmof will
586 add the Version("X.X.X") qualifier to any class that does not have
587 one.<o:p></o:p></span></p>
588
589 karl 1.1 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
590 mso-bidi-font-family:"Courier New"'>If the option is present without the
591 (x.y.z) it could force the compiler to reject mof that did not have the version
592 qualifier defined for classes.<o:p></o:p></span></p>
593
594 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
595 mso-bidi-font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
596
597 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
598 mso-bidi-font-family:"Courier New"'>There is at least one good reason to
599 provide this as a compiler test (probably in addition to having an internal
600 test) – It would be logical to insure that no mof in a mof file was installed
601 if there were classes without the version qualifier.<o:p></o:p></span></p>
602
603 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
604 mso-bidi-font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
605
606 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
607 mso-bidi-font-family:"Courier New"'>Note that we have seriously considered
608 proposing that there be a version pragma that would accomplish what is being
609 proposed for the command line.<span style="mso-spacerun: yes"> </span>This
610 karl 1.1 would be a more logical solution. However, the negative of that proposal today
611 is that a new pragma touches on the DMTF specifications and until and unless we
612 achieved DMTF agreement to the pragma, we would be out of scope with any MOF
613 that had this pragma.<span style="mso-spacerun: yes"> </span>It is still a
614 useful concept but we do not want to require it when it is not part of the DMTF
615 standards.<o:p></o:p></span></p>
616
617 <p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
618 mso-bidi-font-family:"Courier New"'>Since starting with version 2.6 (march
619 2002) all DMTF schemas will have the Version qualifier, the demand for this
620 option has been reduced.<span style="mso-spacerun: yes"> </span>The
621 originators would be willing to discuss options or possible deletion of this
622 requirement if it was a severe schedule burden.</span><span style='font-family:
623 Arial;mso-bidi-font-family:"Times New Roman"'><br>
624 <br style='mso-special-character:line-break'>
625 <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
626 <![endif]><o:p></o:p></span></p>
627
628 </div>
629
630 </body>
631 karl 1.1
632 </html>
|
Return to
CompilerExtensionstoSupportProviderRegistration.htm
CVS log
Up to [Pegasus] / pegasus / doc / WorkPapers