1 karl  1.1 // ===================================================================
  2           // Title:       Core Method Parameters 2.7
  3           // Filename:    Core27_MethodParms.mof
  4           // Version:     2.7.0
  5           // Release:     Preliminary 
  6           // Date:        07/01/02
  7           // ===================================================================
  8           // Copyright 2002 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 date should always be noted.
 17           //
 18           // Implementation of certain elements of this standard or proposed 
 19           // standard may be subject to third party patent rights, including 
 20           // provisional patent rights (herein "patent rights"). DMTF makes 
 21           // no representations to users of the standard as to the existence 
 22 karl  1.1 // of such rights, and is not responsible to recognize, disclose, or
 23           // identify any or all such third party patent right, owners or 
 24           // claimants, nor for any incomplete or inaccurate identification or 
 25           // disclosure of such rights, owners or claimants. DMTF shall have no 
 26           // liability to any party, in any manner or circumstance, under any 
 27           // legal theory whatsoever, for failure to recognize, disclose, or 
 28           // identify any such third party patent rights, or for such party's
 29           // reliance on the standard or incorporation thereof in its product, 
 30           // protocols or testing procedures. DMTF shall have no liability to 
 31           // any party implementing such standard, whether such implementation 
 32           // is foreseeable or not, nor to any patent owner or claimant, and shall 
 33           // have no liability or responsibility for costs or losses incurred if 
 34           // a standard is withdrawn or modified after publication, and shall be
 35           // indemnified and held harmless by any party implementing the 
 36           // standard from any and all claims of infringement by a patent owner 
 37           // for such implementations.
 38           //
 39           // For information about patents held by third-parties which have 
 40           // notified the DMTF that, in their opinion, such patent may relate to 
 41           // or impact implementations of DMTF standards, visit 
 42           // http://www.dmtf.org/about/policies/disclosures.php.
 43 karl  1.1 // ===================================================================
 44           // Description: The Core Model defines basic management concepts. 
 45           //              This file defines the values of a method's parameters.
 46           //
 47           //              The object classes below are listed in an order that
 48           //              avoids forward references. Required objects, defined 
 49           //              by other working groups, are omitted.
 50           // ==================================================================
 51           // Change Log for v2.7 - None
 52           // ==================================================================
 53           
 54           #pragma locale ("en_US")
 55           
 56           
 57           // ================================================================== 
 58           // MethodParameters 
 59           // ================================================================== 
 60           [Abstract, Version ("2.6.0"), Description (
 61               "  CIM_MethodParameters represents a set of values to be used "
 62               "as the parameters of a method. These parameters may be passed "
 63               "to the method, diretly used by the method in its invocation, "
 64 karl  1.1     "or accessed by the method when it is called. The properties "
 65               "of a concrete subclass of MethodParameters are mapped to the "
 66               "parameters of a method by the method itself or by the method "
 67               "caller. This is an implementation detail independent of the "
 68               "definition of the class. For ease of use, property names "
 69               "should match parameter names. \n"
 70               "  Property values should be set before the method is invoked. " 
 71               "The ModelCorrespondence qualifier can be used to indicate " 
 72               "if the property value should come from another class's property. " 
 73               "The instances that the property values should be gleaned from " 
 74               "should be associated with MethodParameters using the Parameter"
 75               "ValueSources association. If the property is declared as an "
 76               "array, then the same property value (identified by the Model"
 77               "Correspondence) will be retrieved from all appropriate "
 78               "ParameterValueSources instances and stored in the array. If "
 79               "the property is declared as an array and the Model"
 80               "Correspondence is to an array property, then only one instance "
 81               "of the array will be copied from one ParameterValueSource. " 
 82               "If the property is not declared as an array and there are " 
 83               "multiple instances of the class and property associated with " 
 84               "it through ModelCorrespondence where the values are not all "
 85 karl  1.1     "the same, then an error will occur and the property's value "
 86               "will not be set. Several MethodParameters instances can be "
 87               "associated with any ManagedElement's methods. This allows the " 
 88               "maintenance of 'canned' method invocation and reduces the " 
 89               "overhead of recreating all method parameters for every method " 
 90               "invocation.") ] 
 91           class CIM_MethodParameters : CIM_ManagedElement { 
 92               
 93               [Maxlen (256) , Description ( 
 94                   "The identifier by which the MethodParameters object is "
 95                   "known.") ]
 96               string MethodParametersId; 
 97               
 98               [Description ( 
 99                   "The resetValues method updates the values of the properties "
100                   "of MethodParameters which have ModelCorrespondence to the " 
101                   "SourceME ManagedElement. This allows the association of " 
102                   "several source candidates with the MethodParameters with " 
103                   "one being chosen as the source for this set of values. " 
104                   "If resetValues is invoked and sourceME is null, then all " 
105                   "associated MEs in ParameterValueSources will be used " 
106 karl  1.1         "to set the values of the MethodParameters properties.") ]
107                uint32 ResetValues(
108                    [IN] CIM_ManagedElement REF SourceME); 
109           }; 
110           
111           
112           // =================================================================== 
113           // ParameterValueSources 
114           // =================================================================== 
115           [Association, Version ("2.6.0"), Description ( 
116               "ParameterValueSources represents the association between " 
117               "a MethodParameters instance and the ManagedElement instances " 
118               "which contain properties to be used to create values " 
119               "for the MethodParameters properties.") ] 
120           class CIM_ParameterValueSources {        
121                 
122               [Key, Description ( 
123                   "The MethodParameters instance whose property values "
124                   "are to be set.") ] 
125               CIM_MethodParameters REF Parameters; 
126               
127 karl  1.1     [Key, Description (
128                   "The ManagedElement which contains properties to be used " 
129                   "to populate the values of the properties of the "
130                   "MethodParameters instance.") ] 
131               CIM_ManagedElement REF ValueSource; 
132           }; 
133           
134           
135           // =================================================================== 
136           // ParametersForMethod 
137           // =================================================================== 
138           [Association, Version ("2.6.0"), Description ( 
139               "ParametersForMethod represents the association between "
140               "MethodParameters class(es) and a ManagedElement which has a "
141               "method that may use the MethodParameters during its "
142               "invocation. This association is optional, as the Method"
143               "Parameters instance may be passed as a parameter to a method " 
144               "or used to create a method signature before the method is "
145               "invoked. This association is useful for finding all the valid "
146               "MethodParameters instances for a particular method. It may "
147               "be particularly useful for user-oriented interfaces and "
148 karl  1.1     "automated or policy driven method invocations.") ] 
149           class CIM_ParametersForMethod {       
150               
151               [Key, Description (
152                   "The MethodParameters instance which may be used by the "
153                   "ParametersForMethod's method invocation.") ]
154               CIM_MethodParameters REF Parameters;
155               
156               [Key, Description ("The ManagedElement which has "
157                   "a method that may use this instance of MethodParameters.") ]
158               CIM_ManagedElement REF TheMethod;
159               
160               [Key, MaxLen(64),Description ("The name of the method that "
161                   "may use the referenced instance of MethodParameters during "
162                   "its invocation.") ]
163               string MethodName;
164           }; 
165           
166           
167           // ===================================================================
168           // end of file
169 karl  1.1 // ===================================================================