1 mike 1.2 // ==================================================================
2 // Title: Core MOF Specification Additions 2.5
3 // Filename: CIM_CoreAdditions25.MOF
4 // Version: 2.5
5 // Date: 06/12/2001
6 // Release: 0
7 // Description: The object classes below are new to the version stated
8 // above and are being evaluated in premliminary release
9 // status.
10 // ===================================================================
11 // Author: DMTF System and Devices Working Group
12 // ==================================================================
13 // Date 12/01/2000 Version 2.5
14 // - CR538a Add MethodParameters class and associations.
15 // - CR555b Define the classes, SystemSetting and
16 // SystemConfiguration, and appropriate associations
17 // - CR585 Company review Changes from Compaq
18 // 2.) Add CIM_ to CIM_MethodParameters.ResetValues() input
19 // parameter ManagedElement ref
20 // Date 05/24/2001 Version 2.5 Final
21 // Changed format of classes to be consistent.
22 mike 1.2 //
23 // ==================================================================
24
25 // ==================================================================
26 //
27 // Elements and Collections
28 //
29 // ==================================================================
30
31 // ==================================================================
32 // CIM_SystemSetting
33 // ==================================================================
34 [Abstract, Description (
35 "CIM_SystemSetting represents the general concept "
36 "of a CIM_Setting which is scoped by/weak to a System.")]
37 class CIM_SystemSetting : CIM_Setting {
38 [Propagated ("CIM_System.CreationClassName"), Key,
39 MaxLen (256), Description (
40 "The scoping System's CreationClassName.") ]
41 string SystemCreationClassName;
42 [Propagated ("CIM_System.Name"), Key, MaxLen (256),
43 mike 1.2 Description ("The scoping System's Name.") ]
44 string SystemName;
45 [Key, MaxLen (256), Description (
46 "CreationClassName indicates the name of the class or the "
47 "subclass used in the creation of an instance. When used "
48 "with the other key properties of this class, this property "
49 "allows all instances of this class and its subclasses to "
50 "be uniquely identified.") ]
51 string CreationClassName;
52 [Override ("SettingID"), Key, MaxLen (256)]
53 string SettingID;
54 };
55
56
57 // ==================================================================
58 // CIM_SettingForSystem
59 // ==================================================================
60 [Association, Description (
61 "CIM_SettingForSystem defines a Setting in the context of the "
62 "System on which it resides.")]
63 class CIM_SettingForSystem : CIM_Dependency {
64 mike 1.2 [Override ("Antecedent"), Max (1), Min (1),
65 Description ("The hosting System.")]
66 CIM_System REF Antecedent;
67 [Override ("Dependent"), Weak,
68 Description ("The Setting defined for the System.")]
69 CIM_SystemSetting REF Dependent;
70 };
71
72 // ==================================================================
73 //
74 // Products, FRUs, and Statistics
75 //
76 // ==================================================================
77
78 // ==================================================================
79 //
80 // Settings and Configuration
81 //
82 // ==================================================================
83
84 // ==================================================================
85 mike 1.2 // MethodParameters
86 // ==================================================================
87 [Abstract, Description (
88 "CIM_MethodParameters represents a set of values to be used as "
89 "the parameters of a method These parameters may be passed to "
90 "the method, diretly used by the method in its invocation, or "
91 "accessed by the method when it is called. The properties of "
92 "a concrete subclass of MethodParameters are mapped to the "
93 "parameters of a method by the method itself or by the method "
94 "caller. This is an implementation detail independent of the "
95 "definition of the class. For ease of use, property names "
96 "should match parameter names. \n\n"
97 "Property values should be set before the method is invoked. "
98 "The ModelCorrespondence qualifier can be used to indicate if "
99 "the property value should come from another class's property. "
100 "The instances that the property values should be gleaned from "
101 "should be associated with MethodParameters using the Parameter"
102 "ValueSources association. If the property is declared as an "
103 "array, then the same property value (identified by the Model"
104 "Correspondence) will be retrieved from all appropriate Parameter"
105 "ValueSources instances and stored in the array. If the property "
106 mike 1.2 "is declared as an array and the ModelCorrespondence is to an array "
107 "property, then only one instance of the array will be copied from "
108 "one ParameterValueSource. If the property is not declared as "
109 "an array and there are multiple instances of the class and "
110 "property associated with it through model correspondence where "
111 "the values are not all the same, then an error will occur and "
112 "the property's value will not be set. Several MethodParameters "
113 "instances can be associated with any ManagedElement's methods. "
114 "This allows the maintenance of 'canned' method invocation and "
115 "reduces the overhead of recreating all method parameters for "
116 "every method invocation.") ]
117 class CIM_MethodParameters : CIM_ManagedElement {
118 [MaxLen (256) , Description (
119 "The identifier by which the MethodParameters object is known.") ]
120 string MethodParametersId ;
121 [Description (
122 "The resetValues method updates the values of the properties of "
123 "MethodParameters which have ModelCorrespondence to the "
124 "SourceME ManagedElement. This allows the association of "
125 "several source candidates with the MethodParameters with "
126 "one being chosen as the source for this set of values. "
127 mike 1.2 "If resetValues is invoked and sourceME is null, then all "
128 "associated MEs in ParameterValueSources will be used "
129 "to set the values of the MethodParameters properties. ")]
130 uint32 ResetValues(
131 [IN] CIM_ManagedElement ref SourceME );
132 };
133
134
135 // ===================================================================
136 // ParameterValueSources
137 // ===================================================================
138 [Association, Description (
139 "ParameterValueSources represents the association between "
140 "a MethodParameters instance and the ManagedElement instances "
141 "which contain properties to be used to create values "
142 "for the MethodParameters properties. " ) ]
143 class CIM_ParameterValueSources {
144 [Key, Description (
145 "The MethodParameters instance whose property values are to "
146 "be set.") ]
147 CIM_MethodParameters ref Parameters;
148 mike 1.2 [Key, Description (
149 "The ManagedElement which contains properties to be used to "
150 "populate the values of the properties of the MethodParameters "
151 "instance.") ]
152 CIM_ManagedElement ref ValueSource;
153 };
154
155
156 // ===================================================================
157 // ParametersForMethod
158 // ===================================================================
159 [Association, Description (
160 "ParametersForMethod represents the association between Method"
161 "Parameters class(es) and a ManagedElement which has a method "
162 "may use this MethodParameters instance during its invocation. "
163 "This association is optional, as the MethodParameters instance "
164 "may be passed as a parameter to a method or used to create a "
165 "method signature before the method is invoked. This association "
166 "is useful for finding all the valid MethodParameters instances "
167 "for a particular method. This may be particularly useful for "
168 "user oriented interfaces and automated or policy driven method "
169 mike 1.2 "invocations.") ]
170 class CIM_ParametersForMethod {
171 [Key, Description (
172 "The MethodParameters instance which may be used by the "
173 "ParametersForMethod's method invocation.") ]
174 CIM_MethodParameters ref Parameters;
175 [Key, Description (
176 "The ManagedElement which has a method that may use this "
177 "instance of MethodParameters.") ]
178 CIM_ManagedElement ref TheMethod;
179 [Key, MaxLen(64),Description (
180 "The name of the method that may use this instance of "
181 "MethodParameters during its invocation.") ]
182 string MethodName;
183 };
184
185
186 // ==================================================================
187 // CIM_SystemConfiguration
188 // ==================================================================
189 [Description (
190 mike 1.2 "CIM_SystemConfiguration represents the general concept of a "
191 "CIM_Configuration which is scoped by/weak to a System. This "
192 "class is a peer of CIM_Configuration since the key structure "
193 "of Configuration is currently defined and cannot be modified "
194 "with additional properties.") ]
195 class CIM_SystemConfiguration : CIM_ManagedElement {
196 [Propagated ("CIM_System.CreationClassName"), Key,
197 MaxLen (256), Description (
198 "The scoping System's CreationClassName.") ]
199 string SystemCreationClassName;
200 [Propagated ("CIM_System.Name"), Key, MaxLen (256),
201 Description ("The scoping System's Name.") ]
202 string SystemName;
203 [Key, MaxLen (256), Description (
204 "CreationClassName indicates the name of the class or the "
205 "subclass used in the creation of an instance. When used "
206 "with the other key properties of this class, this property "
207 "allows all instances of this class and its subclasses to "
208 "be uniquely identified.") ]
209 string CreationClassName;
210 [Key, MaxLen (256), Description (
211 mike 1.2 "The label by which the Configuration object is known.") ]
212 string Name;
213 };
214
215
216 // ==================================================================
217 // CIM_ConfigurationForSystem
218 // ==================================================================
219 [Association, Description (
220 "CIM_ConfigurationForSystem defines a Configuration "
221 "in the context of the System on which it resides.") ]
222 class CIM_ConfigurationForSystem : CIM_Dependency {
223 [Override ("Antecedent"), Max (1), Min (1),
224 Description ("The hosting System.")]
225 CIM_System REF Antecedent;
226 [Override ("Dependent"), Weak,
227 Description ("The Configuration defined for the System.")]
228 CIM_SystemConfiguration REF Dependent;
229 };
230
231
232 mike 1.2 // ==================================================================
233 // CIM_SystemSettingContext
234 // ==================================================================
235 [Association, Aggregation, Description (
236 "This relationship associates System-specific Configuration "
237 "objects with System-specific Setting objects, similar to the "
238 "SettingContext association.")]
239 class CIM_SystemSettingContext {
240 [Aggregate, Key, Description (
241 "The Configuration object that aggregates the Setting.") ]
242 CIM_SystemConfiguration REF Context;
243 [Key, Description ("An aggregated Setting.")]
244 CIM_SystemSetting REF Setting;
245 };
246
247
248 // ===================================================================
249 // end of file
250 // ===================================================================
|