(file) Return to CompilerExtensionstoSupportProviderRegistration.htm CVS log (file) (dir) Up to [Pegasus] / pegasus / doc / WorkPapers

File: [Pegasus] / pegasus / doc / WorkPapers / CompilerExtensionstoSupportProviderRegistration.htm (download) / (as text)
Revision: 1.1, Fri Feb 22 16:56:23 2002 UTC (22 years, 3 months ago) by karl
Branch: MAIN
import new paper

<html xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns="http://www.w3.org/TR/REC-html40">

<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 9">
<meta name=Originator content="Microsoft Word 9">
<link rel=File-List
href="./CompilerExtensionstoSupportProviderRegistration_files/filelist.xml">
<title>Pegasus Project Working Paper</title>
<!--[if gte mso 9]><xml>
 <o:DocumentProperties>
  <o:Author>Karl</o:Author>
  <o:Template>Pegasus Project Working Paper.dot</o:Template>
  <o:LastAuthor>Karl</o:LastAuthor>
  <o:Revision>8</o:Revision>
  <o:TotalTime>141</o:TotalTime>
  <o:LastPrinted>2002-02-22T16:51:00Z</o:LastPrinted>
  <o:Created>2002-02-22T16:20:00Z</o:Created>
  <o:LastSaved>2002-02-22T16:54:00Z</o:LastSaved>
  <o:Pages>3</o:Pages>
  <o:Words>1283</o:Words>
  <o:Characters>7316</o:Characters>
  <o:Company>Inova</o:Company>
  <o:Lines>60</o:Lines>
  <o:Paragraphs>14</o:Paragraphs>
  <o:CharactersWithSpaces>8984</o:CharactersWithSpaces>
  <o:Version>9.4402</o:Version>
 </o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <w:WordDocument>
  <w:Zoom>75</w:Zoom>
  <w:AttachedTemplate HRef="Pegasus Project Working Paper.dot"></w:AttachedTemplate>
 </w:WordDocument>
</xml><![endif]-->
<style>
<!--
 /* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
	{mso-style-parent:"";
	margin:0in;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
h1
	{mso-style-next:Normal;
	margin-top:12.0pt;
	margin-right:0in;
	margin-bottom:3.0pt;
	margin-left:0in;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:1;
	font-size:16.0pt;
	font-family:Arial;
	mso-font-kerning:16.0pt;}
h2
	{mso-style-next:Normal;
	margin:0in;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:2;
	font-size:12.0pt;
	mso-bidi-font-size:10.0pt;
	font-family:"Courier New";}
p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
	{margin:0in;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:10.0pt;
	font-family:"Courier New";
	mso-fareast-font-family:"Times New Roman";}
p.PaperTitle, li.PaperTitle, div.PaperTitle
	{mso-style-name:PaperTitle;
	margin:0in;
	margin-bottom:.0001pt;
	text-align:center;
	mso-pagination:widow-orphan;
	font-size:24.0pt;
	mso-bidi-font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";
	font-weight:bold;
	mso-bidi-font-weight:normal;}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.25in 1.0in 1.25in;
	mso-header-margin:.5in;
	mso-footer-margin:.5in;
	mso-paper-source:0;}
div.Section1
	{page:Section1;}
 /* List Definitions */
@list l0
	{mso-list-id:8916730;
	mso-list-type:hybrid;
	mso-list-template-ids:1862858776 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l1
	{mso-list-id:813445812;
	mso-list-type:hybrid;
	mso-list-template-ids:1400267148 67698703 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l2
	{mso-list-id:836923935;
	mso-list-type:hybrid;
	mso-list-template-ids:-1555669326 67698689 1935563580 1644480232 1693206816 -962706662 -934745516 528001178 -1798818850 764575260;}
@list l2:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
@list l3
	{mso-list-id:1391613595;
	mso-list-type:hybrid;
	mso-list-template-ids:-2027158932 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l3:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
@list l4
	{mso-list-id:1412967939;
	mso-list-type:hybrid;
	mso-list-template-ids:-1458692366 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l4:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
@list l5
	{mso-list-id:1654481399;
	mso-list-type:hybrid;
	mso-list-template-ids:-2096598596 67698689 1440661024 -2121751836 1891401522 746083054 -538574160 -1957930924 -343529822 -1785850398;}
@list l5:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
@list l6
	{mso-list-id:1689333165;
	mso-list-type:hybrid;
	mso-list-template-ids:-263048826 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l6:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
@list l7
	{mso-list-id:1721858141;
	mso-list-type:hybrid;
	mso-list-template-ids:-2000788846 67698689 1643545156 -559619832 -2132085430 -550596614 379464750 879668152 1047431978 1261200574;}
@list l7:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	font-family:Symbol;}
ol
	{margin-bottom:0in;}
ul
	{margin-bottom:0in;}
-->
</style>
</head>

<body lang=EN-US style='tab-interval:.5in'>

<div class=Section1>

<p class=PaperTitle>Pegasus Project Working Paper</p>

<p class=PaperTitle>Compiler Extensions to Support Provider Registration</p>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<p class=MsoNormal><b>Authors:</b> Denise Eckstein, Karl Schopmeyer</p>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<p class=MsoNormal><span style='font-size:8.0pt;mso-bidi-font-size:12.0pt'>Last
Update <span style='mso-field-code:"SAVEDATE  \\* MERGEFORMAT"'>2/22/2002 10:31
AM</span><o:p></o:p></span></p>

<p class=MsoNormal><span style='font-size:8.0pt;mso-bidi-font-size:12.0pt'>Document:
<span style='mso-field-code:"FILENAME  \\* MERGEFORMAT"'>CompilerExtensionstoSupportProviderRegistration.htm</span><o:p></o:p></span></p>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<p class=MsoNormal>Revision Status</p>

<table border=1 cellspacing=0 cellpadding=0 style='border-collapse:collapse;
 border:none;mso-border-alt:solid windowtext .5pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>
 <tr>
  <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
  padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal>0.1</p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
  border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal>KS</p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
  border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal>Draft for discussion</p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
  border-left:none;mso-border-left-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
 </tr>
 <tr>
  <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
  border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
  none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
  mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
  padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
  none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
  mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
  padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
  none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
  mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
  padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
 </tr>
 <tr>
  <td width=148 valign=top style='width:110.7pt;border:solid windowtext .5pt;
  border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
  none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
  mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
  padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
  none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
  mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
  padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td width=148 valign=top style='width:110.7pt;border-top:none;border-left:
  none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;
  mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
  padding:0in 5.4pt 0in 5.4pt'>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
 </tr>
</table>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<h1>Introduction</h1>

<p class=MsoNormal>This document defines a set of extensions to the Pegasus Cim
Compiler to help with the process of registering providers using MOF and the
compiler as the registration tool.<span style="mso-spacerun: yes">  </span>The
additional functions are felt to be requirements to create an environment in
Pegasus Version 2 that is usable for provider installation and registration in
running Pegasus systems.</p>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<h1>Background</h1>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>These
proposed extensions started with work done by HP to define some rules and
possible extensions to the system to help control the input of MOF for provider
registration.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>We
have to assume that provider registration can be done at any time, not simply
at build of a new system and must be done when the cimom is running.<span
style="mso-spacerun: yes">  </span>Further, it is intended that this be done by
inputting MOF to the system.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
is one of the characteristics that drives us to create the version of the CIM
compiler that is driven from the client interface and can input when the CIMOM
is running.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Further
extensions revolve around:<o:p></o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list .5in'><span
     style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>The
     providers not necessarily knowing what is in the CIMOM when they create
     their registration MOF.<o:p></o:p></span></li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list .5in'><span
     style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Controlling
     input to reduce the possibility that providers can input incorrect
     versions of MOF.<o:p></o:p></span></li>
</ul>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
set of extensions goes handin-hand with a set of changes that were just
approved by the DMTF:<o:p></o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='mso-list:l4 level1 lfo6;tab-stops:list .5in'><span
     style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Mandatory
     use of the Version Qualifier in the future, starting with the CIM 2.6
     Final release scheduled for March 2002.<span style="mso-spacerun: yes"> 
     </span>All classes in the CIM schema must have this qualifier which
     defines the last CIM Schema version in which the class itself was modified
     (ex. Version (2.6.0).<o:p></o:p></span></li>
</ul>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>The
use of the Experimental Qualifier that identifies all classes that are
considered experimental and not released.<span style="mso-spacerun: yes"> 
</span>Generally we should Never see the experimental qualifier on any classes
in a released version of the CIM MOF and should see it only on classes that
change or are added for a preliminary release.<span style="mso-spacerun: yes"> 
</span>All of these classes must be either moved to release or removed from the
Schema to allow a schema to move to release status within the DMTF.<span
style="mso-spacerun: yes">  </span></span><span style='mso-bidi-font-size:10.0pt;
font-family:Arial;mso-bidi-font-family:"Courier New"'>The String representing
the version MUST be in the form of:&nbsp; </span><span style='font-family:Arial;
mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>

<h2><span style='font-family:Arial;mso-bidi-font-family:"Courier New"'><span
style="mso-spacerun: yes">   </span>M + &quot;.&quot; + N + &quot;.&quot; + U<o:p></o:p></span></h2>

<p class=MsoNormal style='margin-left:1.0in'><span style='mso-bidi-font-size:
10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'><br>
<b>M - </b>The major version in numeric form in which the class was
changed.&nbsp; <br>
<b>N</b> - The minor version in numeric form in which the class was
changed.&nbsp; <br>
<b>U</b> - The update (e.g. errata, patch, ...) in numeric form in which the
class was changed.</span><span style='font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>&nbsp;</span><span style='font-family:Arial;
mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>More
information about these changes will be available from the DMTF when CIM
version 2.6 final is released.</span></p>

<h1>The Definition of Provider Guidelines</h1>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>The
following guidelines for providers and provider writers help to understand
these requirements:<o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>&nbsp;</span><br>
<span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Courier New"'>1.) Provider Developer's SHOULD include the definition of all
required superclasses in the MOF.</span><span style='font-family:Arial;
mso-bidi-font-family:"Times New Roman"'><br>
</span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Courier New"'>2.) All class definitions MUST include a VERSION qualifier.</span><span
style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><br>
</span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Courier New"'>3.) Use of the VERSION qualifier string MUST comply with the
DMTF guidelines.&nbsp; In particular, any change that breaks backward compatibility
MUST be labeled with a new MAJOR version number.</span><span style='font-family:
Arial;mso-bidi-font-family:"Times New Roman"'><br>
</span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Courier New"'>4.) All included class definitions MUST contain a complete and
accurate definition of the specified version of the class.</span><span
style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><br>
</span><span style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Courier New"'>5.) Provider Developer's SHOULD assume that DMTF qualifiers
(version 2.6) are already defined in the namespace.<o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoBodyText><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
font-family:Arial;mso-bidi-font-family:"Courier New"'>This MOF Update Utility
is a very simple tool that supports a majority of the provider installation
senarios.&nbsp; It handles&nbsp;the straight-forward upgrade
cases.&nbsp;&nbsp;Situations that require more&nbsp;sophisticated Schema
manipulation&nbsp; will require developers to write a
customize&nbsp;CIM&nbsp;Client application to perform the necessary checks and
schema modifications.&nbsp; E.g., a customized application could be developed
to perform a MAJOR version upgrade.<o:p></o:p></span></p>

<h1><span style='font-size:12.0pt;mso-bidi-font-size:16.0pt'>MOF Enhancements
to Support Provider Registration<o:p></o:p></span></h1>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>General
changes<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<ol style='margin-top:0in' start=1 type=1>
 <li class=MsoNormal style='mso-list:l0 level1 lfo9;tab-stops:list .5in'><span
     style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Extend
     the compiler to allow class replacement. Thus, the compiler would be able
     to replace classes as well as install classes under circumstances defined
     in this document<o:p></o:p></span></li>
 <li class=MsoNormal style='mso-list:l0 level1 lfo9;tab-stops:list .5in'><span
     style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Extend
     the compiler to allow use through the client interface.<span
     style="mso-spacerun: yes">  </span>The proposed solution is to provide two
     versions of the compiler.<span style="mso-spacerun: yes">  </span>One
     would be used through the reposiotory interface (as is done today). The
     second version would use the client interface and would be used only when
     the CIMServer was running.<o:p></o:p></span></li>
</ol>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Epecific
option additions<o:p></o:p></span></p>

<ol style='margin-top:0in' start=1 type=1>
 <li class=MsoNormal style='mso-list:l1 level1 lfo12;tab-stops:list .5in'><span
     style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
     "Courier New"'>Add a new parameter to the cimmof command line,
     --experimental, to control handling of the experimental classes and
     qualifiers.<o:p></o:p></span></li>
 <li class=MsoNormal style='mso-list:l1 level1 lfo12;tab-stops:list .5in'><span
     style='mso-bidi-font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
     "Courier New"'>Add a new parameter to the cimmof command line,
     --version=X.X.X, to allow easy migration of existing MOF files to use
     versioning.</span><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>&nbsp;
     <o:p></o:p></span></li>
</ol>

<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Courier New"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<h1><span style='mso-bidi-font-size:10.0pt;font-family:"Courier New"'>--Experimental
Option</span><span style='font-size:12.0pt;mso-bidi-font-size:10.0pt;
font-family:"Courier New"'><o:p></o:p></span></h1>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>NOTE:
References to the Minor version defined below also apply to the update
parameter in the Version qualifier.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>The
--experimental parameter on the command line must be set to allow the CIMMOF to
replace an EXPERIMENTAL class definition with either an EXPERIMENTAL or
RELEASED class definition (in short to be replaced) if the modification is not
a MINOR version&nbsp; or REVISION update to the class.&nbsp; If the --
experimental parameter is not defined and any class in a MOF definition is
experimental, the&nbsp;entire MOF must be rejected (with no changes to the
repository) unless that new class definition represents a MINOR version update
or REVISION update as defined by the VERSION qualifier.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
option was originally defined as follows hopefully the definitions above and
below match):<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>A MOF will be rejected if ...</span><span
style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'> <o:p></o:p></span></p>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
     require replacing a class definition with a MAJOR version update. <o:p></o:p></span></li>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>If the
     --experimental parameter IS NOT specified and it would require replacing
     an EXPERIMENTAL class definition with either an updated EXPERIMENTAL class
     definition or RELEASED class definition.<span style="mso-spacerun: yes"> 
     </span>The justification is that replacing an EXPERIMENTAL with a RELEASED
     or EXPERIMENTAL class could break other classes ... We wanted to make this
     action explicit<o:p></o:p></span></li>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
     require replacing a RELEASED class definition with an EXPERIMENTAL class
     definition. <o:p></o:p></span></li>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
     require replacing a class with an earlier MAJOR version number. <o:p></o:p></span></li>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l5 level1 lfo15;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>If the
     --version parameter IS NOT specified and a class definition does not
     contain a VERSION qualifier.</span><span style='font-family:Arial;
     mso-bidi-font-family:"Times New Roman"'> <o:p></o:p></span></li>
</ul>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>A class definition within a MOF will be
ignored if ...</span><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>
<o:p></o:p></span></p>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l2 level1 lfo18;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It would
     result in replacing a class definition with one with an earlier MINOR
     version number. </span><span style='font-family:Arial;mso-bidi-font-family:
     "Times New Roman"'><o:p></o:p></span></li>
</ul>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>An existing class definition will be
replaced if ...</span><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>
<o:p></o:p></span></p>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l7 level1 lfo21;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>It represents
     an MINOR version update. <o:p></o:p></span></li>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l7 level1 lfo21;tab-stops:list .5in'><span style='mso-bidi-font-size:
     10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>If the
     --experimental parameter IS specified and it would require replacing an
     EXPERIMENTAL class definition with either an updated EXPERIMENTAL class
     definition or RELEASED class definition. </span><span style='font-family:
     Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></li>
</ul>

<p class=MsoNormal><b><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>NOTE:</span></b><span
style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'> Note the use
of the word ignored vs. rejected.<span style="mso-spacerun: yes">  </span>The
requirement is to reject the entire MOF file under certain circumstances.<o:p></o:p></span></p>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>This
means that somehow the compiler must predetermine if there are any reasons for
rejecting the MOF BEFORE it puts any classes into the repository</span>.<span
style="mso-spacerun: yes">  </span>While this implies a multiplass compiler, we
hope that there is some way this can be creatively accomplished without major
changes to the compiler (ex. creating a super process that would simply call
the compiler with different options for the check phase).</p>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<h1>--Version Option</h1>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Variations
of his option can be use for two things:<o:p></o:p></span></p>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal style='mso-list:l6 level1 lfo24;tab-stops:list .5in'><span
     style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Force the
     version qualifier to be put on each class.<o:p></o:p></span></li>
 <li class=MsoNormal style='mso-list:l6 level1 lfo24;tab-stops:list .5in'><span
     style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>Test and
     insure that the version qualifier is on each class and reject the input if
     there is any class without the qualifier.<o:p></o:p></span></li>
</ul>

<p class=MsoNormal><span style='font-family:Arial;mso-bidi-font-family:"Times New Roman"'>If
the options is present with the (x.x.x) </span><span style='mso-bidi-font-size:
10.0pt;font-family:Arial;mso-bidi-font-family:"Courier New"'>the cimmof will
add the Version(&quot;X.X.X&quot;) qualifier to any class that does not have
one.<o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>If the option is present without the
(x.y.z) it could force the compiler to reject mof that did not have the version
qualifier defined for classes.<o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>There is at least one good reason to
provide this as a compiler test (probably in addition to having an internal
test) – It would be logical to insure that no mof in a mof file was installed
if there were classes without the version qualifier.<o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>Note that we have seriously considered
proposing that there be a version pragma that would accomplish what is being
proposed for the command line.<span style="mso-spacerun: yes">  </span>This
would be a more logical solution. However, the negative of that proposal today
is that a new pragma touches on the DMTF specifications and until and unless we
achieved DMTF agreement to the pragma, we would be out of scope with any MOF
that had this pragma.<span style="mso-spacerun: yes">  </span>It is still a
useful concept but we do not want to require it when it is not part of the DMTF
standards.<o:p></o:p></span></p>

<p class=MsoNormal><span style='mso-bidi-font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Courier New"'>Since starting with version 2.6 (march
2002) all DMTF schemas will have the Version qualifier, the demand for this
option has been reduced.<span style="mso-spacerun: yes">  </span>The
originators would be willing to discuss options or possible deletion of this
requirement if it was a severe schedule burden.</span><span style='font-family:
Arial;mso-bidi-font-family:"Times New Roman"'><br>
<br style='mso-special-character:line-break'>
<![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
<![endif]><o:p></o:p></span></p>

</div>

</body>

</html>

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2