1 karl  1.1.2.2 // 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 karl  1.1.2.2        "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 karl  1.1.2.2           "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 karl  1.1.2.2           "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 karl  1.1.2.2    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 karl  1.1.2.2           "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 karl  1.1.2.2           "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               };