1 marek 1.1 // Copyright (c) 2009 DMTF.  All rights reserved.
  2              [Association, Aggregation, Version ( "2.22.1" ), 
  3               UMLPackagePath ( "CIM::Core::Settings" ), 
  4               Description ( 
  5                  "This association indicates that the non-null, non-key set of "
  6                  "properties of the component SettingData instance specifies "
  7                  "some capabilities of the associated Capabilities instance. The "
  8                  "interpretation of the set of properties in the associated "
  9                  "SettingData is governed by the properties: PropertyPolicy and ValueRole.\n"
 10                  "For a particular Capabilities instance, the complete set of "
 11                  "Component SettingData instances, together with properties of "
 12                  "the Capabilities instance itself, defines the overall range of "
 13                  "supported capabilities.\n"
 14                  "PropertyPolicy determines whether the properties of the set "
 15                  "are interpreted independently or as a whole (i.e. correlated.)\n"
 16                  "ValueRole further qualifies the members of the set.\n"
 17                  "This association eliminates the need to define and maintain "
 18                  "corresponding property definitions and values in both a "
 19                  "Capabilities subclass and a SettingData subclass.\n"
 20                  "Typically these setting instances will be published along with "
 21                  "the associated Capabilities instance and will not be "
 22 marek 1.1        "modifiable by the client." )]
 23           class CIM_SettingsDefineCapabilities : CIM_Component {
 24           
 25                 [Aggregate, Override ( "GroupComponent" ), 
 26                  Max ( 1 ), 
 27                  Description ( "The Capabilities instance." )]
 28              CIM_Capabilities REF GroupComponent;
 29           
 30                 [Override ( "PartComponent" ), 
 31                  Description ( 
 32                     "A Setting used to define the associated Capabilities instance."
 33                      )]
 34              CIM_SettingData REF PartComponent;
 35           
 36                 [Required, Description ( 
 37                     "PropertyPolicy defines whether or not the non-null, "
 38                     "non-key properties of the associated SettingData "
 39                     "instance are treated independently or as a correlated "
 40                     "set. For instance, an independent set of maximum "
 41                     "properties might be defined, when there is no "
 42                     "relationship between each property. On the other hand, "
 43 marek 1.1           "several correlated sets of maximum properties might need "
 44                     "to be defined when the maximum values of each are "
 45                     "dependent on some of the others." ), 
 46                  ValueMap { "0", "1", ".." }, 
 47                  Values { "Independent", "Correlated", "DMTF Reserved" }, 
 48                  ModelCorrespondence { 
 49                     "CIM_SettingsDefineCapabilities.ValueRole", 
 50                     "CIM_SettingsDefineCapabilities.ValueRange" }]
 51              uint16 PropertyPolicy = 0;
 52           
 53                 [Description ( 
 54                     "The ValueRole property indicates further semantics on "
 55                     "the interpretation of the non-null, non-key properties "
 56                     "of the Component SettingData.\n"
 57                     "\"Default\" indicates that property values of the "
 58                     "component SettingData instance will be used as default "
 59                     "values, when a new SettingData instance is created for "
 60                     "elements whose capabilities are defined by the "
 61                     "associated Capabilities instance.\n"
 62                     "Across instances of settingdata, for particular "
 63                     "properties having the same semantic purpose, at most one "
 64 marek 1.1           "such settingdata instance shall be specified as a default.\n"
 65                     "\"Optimal\" indicates that the SettingData instance "
 66                     "represents optimal setting values for elements "
 67                     "associated with the associated capabilities instance. "
 68                     "Multiple component SettingData instances may be declared "
 69                     "as optimal.\"Mean\" indicates that the non-null, "
 70                     "non-key, non-enumerated, non-boolean, numeric properties "
 71                     "of the associated SettingData instance represents an "
 72                     "average point along some dimension. For different "
 73                     "combinations of SettingData properties, multiple "
 74                     "component SettingData instances may be declared as "
 75                     "\"Mean\". \"Supported\" indicates that the non-null, "
 76                     "non-key properties of the Component SettingData instance "
 77                     "represents a set of supported property values that are "
 78                     "not otherwise qualified." ), 
 79                  ValueMap { "0", "1", "2", "3", ".." }, 
 80                  Values { "Default", "Optimal", "Mean", "Supported", 
 81                     "DMTF Reserved" }, 
 82                  ModelCorrespondence { 
 83                     "CIM_SettingsDefineCapabilities.PropertyPolicy", 
 84                     "CIM_SettingsDefineCapabilities.ValueRange" }]
 85 marek 1.1    uint16 ValueRole = 3;
 86           
 87                 [Description ( 
 88                     "The ValueRange property indicates further semantics on "
 89                     "the interpretation of all non-null, non-key properties "
 90                     "of the Component SettingData.\n"
 91                     "\"Point\" indicates that this SettingData instance "
 92                     "provides a single set of values.\n"
 93                     "\"Minimums\", \"Maximums\", and \"Increments\", are only "
 94                     "evaluated against non-null, non-key, non-enumerated, "
 95                     "non-boolean, numeric properties of the SettingData "
 96                     "instance. Each property of that set shall be "
 97                     "mathematically comparable to other instances of that property.\n"
 98                     "\"Minimums\" indicates that this SettingData instance "
 99                     "provides minimum values for evaluated properties. When "
100                     "used with PropertyPolicy = \"Independent\", only one "
101                     "such setting per particular SettingData instance shall "
102                     "be specified for any Capabilities. Unless restricted by "
103                     "a Maximums on the same set of properties, all values "
104                     "that compare higher than the specified values are also "
105                     "considered to be supported by the associated "
106 marek 1.1           "capabilities instance. \n"
107                     "\"Maximums\" indicates that this SettingData instance "
108                     "provides maximum values for evaluated properties. When "
109                     "used with PropertyPolicy = \"Independent\", only one "
110                     "such setting per particular SettingData instance shall "
111                     "be specified for any Capabilities. Unless restricted by "
112                     "a Minimums on the same set of properties, all values "
113                     "that compare lower than the specified values are also "
114                     "considered to be supported by the associated "
115                     "capabilities instance.\n"
116                     "\"Increments\" indicates that this SettingData instance "
117                     "provides increment values for evaluated properties. For "
118                     "the associated Capabilities, if an evaluated property "
119                     "currently has no corresponding minimums or maximums, "
120                     "then the property has no affect. Otherwise, for each "
121                     "evaluated property: its value x shall be between the "
122                     "minimum and maximum, inclusively, and shall have the "
123                     "property that both the result of maximum minus x and the "
124                     "result of x minus minimum are each an integer multiple "
125                     "of the increment. If either minimum or maximum is not "
126                     "specified and the other is, then the missing value shall "
127 marek 1.1           "be respectively assumed to be the lowest or highest "
128                     "supported value for the property\'s data-type. "
129                     "Additionally, if both a minimum and a maximum are "
130                     "specified for an evaluated property, then the result of "
131                     "maximum minus minimum shall be an integer multiple of "
132                     "the increment." ), 
133                  ValueMap { "0", "1", "2", "3", ".." }, 
134                  Values { "Point", "Minimums", "Maximums", "Increments", 
135                     "DMTF Reserved" }, 
136                  ModelCorrespondence { 
137                     "CIM_SettingsDefineCapabilities.PropertyPolicy", 
138                     "CIM_SettingsDefineCapabilities.ValueRole" }]
139              uint16 ValueRange = 0;
140           
141           
142           };