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           // ===================================================================