1 krisbash 1.1 // Copyright (c) 2008 DMTF. All rights reserved.
2 [Association, Version ( "2.19.1" ),
3 UMLPackagePath ( "CIM::Core::Settings" ),
4 Description (
5 "ElementSettingData represents the association between "
6 "ManagedElements and applicable setting data. This association "
7 "also describes whether this is a default or current setting. "
8 "Each non-null, non-key property of the associated SettingData "
9 "instance defines a setting value for the associated "
10 "ManagedElement. The properties, IsDefault, IsCurrent, IsNext, "
11 "IsMinimum, IsMaximum, and IsPending further qualify those "
12 "setting values. \n"
13 "Note: the referenced SettingData instance does not reflect the "
14 "current desired state of the referenced ManagedElement unless "
15 "IsCurrent = \"Is Current\". \n"
16 "When IsMinimum and/or IsMaximum properties have the value \"Is "
17 "Minimum\" or \"Is Maximum\" respectively, the referenced "
18 "SettingData instance reflects desired minimum or maximum "
19 "values respectively. When IsMinimum and IsMaximum have any "
20 "other value, the referenced SettingData reflects actual "
21 "desired values." )]
22 krisbash 1.1 class CIM_ElementSettingData {
23
24 [Key, Description ( "The managed element." )]
25 CIM_ManagedElement REF ManagedElement;
26
27 [Key, Description (
28 "The SettingData object that is associated with the element."
29 )]
30 CIM_SettingData REF SettingData;
31
32 [Description (
33 "An enumerated integer that indicates that the referenced "
34 "setting is a default setting for the element or that "
35 "this information is unknown." ),
36 ValueMap { "0", "1", "2" },
37 Values { "Unknown", "Is Default", "Is Not Default" }]
38 uint16 IsDefault;
39
40 [Description (
41 "An enumerated integer that indicates that the referenced "
42 "SettingData represents the last requested values for "
43 krisbash 1.1 "attributes of the Managed Element or that this "
44 "information is unknown. \n"
45 "Attributes of the SettingData itself indicate whether it "
46 "represents the last configuration applied to the "
47 "ManagedElement or is a transient snapshot of the "
48 "requested settings. Current operational characteristics "
49 "of a ManagedElement should be represented with "
50 "properties of the ManagedElement. element or that this "
51 "information is unknown. \n"
52 "For a given ManagedElement and all instances of a "
53 "SettingData subclass, there shall be at most one "
54 "instance of ElementSettingData which references the "
55 "ManagedElement and an instance of the SettingData "
56 "sub-class where there is a specified non-null, non-key "
57 "property of the SettingData sub-class, and the IsMaximum "
58 "property on the referencing ElementSettingData instance "
59 "has a value of \"Is Maximum\" or the IsMinimum property "
60 "on the referencing ElementSettingData instance has a "
61 "value of \"Is Minimum\" and the IsCurrent property on "
62 "the referencing ElementSettingData instance has a value "
63 "of \"Is Current\". There shall be at most one instance "
64 krisbash 1.1 "of ElementSettingData which references a ManagedElement "
65 "and an instance of a SettingData sub-class where the "
66 "IsCurrent property has a value of \"Is Current\" and the "
67 "IsMinimum property does not have a value of \"Is "
68 "Minimum\" and the IsMaximum property does not have a "
69 "value of \"Is Maximum\"." ),
70 ValueMap { "0", "1", "2" },
71 Values { "Unknown", "Is Current", "Is Not Current" }]
72 uint16 IsCurrent;
73
74 [Description (
75 "An enumerated integer indicating whether or not the "
76 "referenced setting is the next setting to be applied. "
77 "For example, the application could take place on a "
78 "re-initialization, reset, reconfiguration request. This "
79 "could be a permanent setting, or a setting used only one "
80 "time, as indicated by the flag. If it is a permanent "
81 "setting then the setting is applied every time the "
82 "managed element reinitializes, until this flag is "
83 "manually reset. However, if it is single use, then the "
84 "flag is automatically cleared after the settings are "
85 krisbash 1.1 "applied. Also note that if this flag is specified (i.e. "
86 "set to value other than \"Unknown\"), then this takes "
87 "precedence over any SettingData that may have been "
88 "specified as Default. For example: If the managed "
89 "element is a computer system, and the value of this flag "
90 "is \"Is Next\", then the setting will be effective next "
91 "time the system resets. And, unless this flag is "
92 "changed, it will persist for subsequent system resets. "
93 "However, if this flag is set to \"Is Next For Single "
94 "Use\", then this setting will only be used once and the "
95 "flag would be reset after that to \"Is Not Next\". So, "
96 "in the above example, if the system reboots in a quick "
97 "succession, the setting will not be used at the second "
98 "reboot." ),
99 ValueMap { "0", "1", "2", "3" },
100 Values { "Unknown", "Is Next", "Is Not Next",
101 "Is Next For Single Use" }]
102 uint16 IsNext;
103
104 [Experimental, Description (
105 "This property affects the interpretation of all "
106 krisbash 1.1 "non-null, non-enumerated, non-binary, numeric, non-key "
107 "properties of the associated SettingData instance. All "
108 "other properties of the associated SettingData instance "
109 "are not affected by this property. \n"
110 "Note: It is assumed that the semantics of each property "
111 "of this set are designed to be compared mathematically. \n"
112 "When IsMinimum = \"Is Miniumum\", this property "
113 "indicates that the affected property values specified in "
114 "the associated SettingData instance shall define desired "
115 "minimum setting values. The operational minimum values "
116 "should be modeled as a properties of the "
117 "CIM_ManagedElement instance.\n"
118 "When IsMinimum = \"Is Not Miniumum\", this property "
119 "indicates that the affected property values specified in "
120 "the associated SettingData instance shall not define "
121 "desired minimum setting values. \n"
122 "When IsMinimum = \"Unknown\", this property indicates "
123 "that the affected property values specified in the "
124 "associated SettingData instance may correspond to "
125 "minimum desired setting values. \n"
126 "When IsMinimum = \"Not Applicable\", this property "
127 krisbash 1.1 "indicates that the affected property values specified in "
128 "the associated SettingData instance shall not be "
129 "interpreted with respect to whether each defines a "
130 "desired minimum." ),
131 ValueMap { "0", "1", "2", "3" },
132 Values { "Unknown", "Not Applicable", "Is Minimum",
133 "Is Not Minimum" }]
134 uint16 IsMinimum = 0;
135
136 [Experimental, Description (
137 "This property affects the interpretation of all "
138 "non-null, non-enumerated, non-binary, numeric, non-key "
139 "properties of the associated SettingData instance. All "
140 "other properties of the associated SettingData instance "
141 "are not affected by this property. \n"
142 "Note: It is assumed that the semantics of each property "
143 "of this set are designed to be compared mathematically. \n"
144 "When IsMaximum = \"Is Maxiumum\", this property "
145 "indicates that the affected property values specified in "
146 "the associated SettingData instance shall define desired "
147 "maximum setting values. The operational maximum values "
148 krisbash 1.1 "should be modeled as a properties of the "
149 "CIM_ManagedElement instance.\n"
150 "When IsMaximum = \"Is Not Maxiumum\", this property "
151 "indicates that the affected property values specified in "
152 "the associated SettingData instance shall not define "
153 "desired maximum setting values. \n"
154 "When IsMaximum = \"Unknown\", this property indicates "
155 "that the affected property values specified in the "
156 "associated SettingData instance may correspond to "
157 "maximum desired setting values. \n"
158 "When IsMaximum = \"Not Applicable\", this property "
159 "indicates that the affected property values specified in "
160 "the associated SettingData instance shall not be "
161 "interpreted with respect to whether each defines a "
162 "desired maximum." ),
163 ValueMap { "0", "1", "2", "3" },
164 Values { "Unknown", "Not Applicable", "Is Maximum",
165 "Is Not Maximum" }]
166 uint16 IsMaximum = 0;
167
168 [Experimental, Description (
169 krisbash 1.1 "An enumerated integer that indicates whether or not the "
170 "referenced CIM_SettingData instance represents "
171 "outstanding changes to the configuration of the "
172 "referenced CIM_ManagedElement that are known to be "
173 "pending and are in the process of being applied. A value "
174 "of 0 \"Unknown\" indicates that the referenced instance "
175 "of CIM_SettingData may represent the last configuration "
176 "applied to the referenced CIM_ManagedElement. A value of "
177 "2 \"Is Pending\" shall indicate that the referenced "
178 "instance of CIM_SettingData represents outstanding "
179 "changes to the configuration of the referenced "
180 "CIM_ManagedElement that are known to be pending. A value "
181 "of 3 \"Is Not Pending\" shall indicate that the "
182 "referenced instance of CIM_SettingData does not "
183 "represent outstanding changes to the configuration of "
184 "the referenced CIM_ManagedElement." ),
185 ValueMap { "0", "2", "3", "..", "32768.." },
186 Values { "Unknown", "Is Pending", "Is Not Pending",
187 "DMTF Reserved", "Vendor Reserved" }]
188 uint16 IsPending = 0;
189
190 krisbash 1.1
191 };
|