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