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