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