1 tony  1.1 // ===================================================================
  2           // Title:       Core Method Parameters 2.8
  3           // Filename:    Core28_MethodParms.mof
  4           // Version:     2.8
  5           // Release:     Preliminary
  6           // Date:        05/22/2003
  7           // ===================================================================
  8           // Copyright 2001-2003 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 tony  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 tony  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.8 - None
 52           // Change Log for v2.7 - None
 53           // ==================================================================
 54           
 55           #pragma locale ("en_US")
 56           
 57           
 58           // ==================================================================
 59           // MethodParameters
 60           // ==================================================================
 61              [Abstract, Version ("2.6.0"), Description (
 62                  "CIM_MethodParameters represents a set of values to be used as "
 63                  "the parameters of a method.  These parameters may be passed to "
 64 tony  1.1        "the method, diretly used by the method in its invocation, or "
 65                  "accessed by the method when it is called.  The properties of a "
 66                  "concrete subclass of MethodParameters are mapped to the "
 67                  "parameters of a method by the method itself or by the method "
 68                  "caller.  This is an implementation detail independent of the "
 69                  "definition of the class.  For ease of use, property names "
 70                  "should match parameter names.\n"
 71                  "Property values should be set before the method is invoked.  "
 72                  "The ModelCorrespondence qualifier can be used to indicate if "
 73                  "the property value should come from another class's property.  "
 74                  "The instances that the property values should be gleaned from "
 75                  "should be associated with MethodParameters using the Parameter "
 76                  "ValueSources association.  If the property is declared as an "
 77                  "array, then the same property value (identified by the Model "
 78                  "Correspondence) will be retrieved from all appropriate "
 79                  "ParameterValueSources instances and stored in the array.  If "
 80                  "the property is declared as an array and the Model "
 81                  "Correspondence is to an array property, then only one instance "
 82                  "of the array will be copied from one ParameterValueSource.  If "
 83                  "the property is not declared as an array and there are "
 84                  "multiple instances of the class and property associated with "
 85 tony  1.1        "it through ModelCorrespondence where the values are not all "
 86                  "the same, then an error will occur and the property's value "
 87                  "will not be set.  Several MethodParameters instances can be "
 88                  "associated with any ManagedElement's methods.  This allows the "
 89                  "maintenance of 'canned' method invocation and reduces the "
 90                  "overhead of recreating all method parameters for every method "
 91                  "invocation.") ]
 92           class CIM_MethodParameters : CIM_ManagedElement {
 93           
 94                 [Description (
 95                     "The identifier by which the MethodParameters object is "
 96                     "known."), 
 97                  MaxLen (256) ]
 98              string MethodParametersId;
 99           
100                 [Description (
101                     "The resetValues method updates the values of the properties "
102                     "of MethodParameters which have ModelCorrespondence to the "
103                     "SourceME ManagedElement.  This allows the association of "
104                     "several source candidates with the MethodParameters with "
105                     "one being chosen as the source for this set of values.  If "
106 tony  1.1           "resetValues is invoked and sourceME is null, then all "
107                     "associated MEs in ParameterValueSources will be used to set "
108                     "the values of the MethodParameters properties.") ]
109              uint32 ResetValues(
110                  [IN] CIM_ManagedElement REF SourceME);
111           };
112           
113           
114           // ===================================================================
115           // ParameterValueSources
116           // ===================================================================
117              [Association, Version ("2.6.0"), Description (
118                  "ParameterValueSources represents the association between a "
119                  "MethodParameters instance and the ManagedElement instances "
120                  "which contain properties to be used to create values for the "
121                  "MethodParameters properties.") ]
122           class CIM_ParameterValueSources {
123           
124                 [Key, Description (
125                     "The MethodParameters instance whose property values are to "
126                     "be set.") ]
127 tony  1.1    CIM_MethodParameters REF Parameters;
128           
129                 [Key, Description (
130                     "The ManagedElement which contains properties to be used to "
131                     "populate the values of the properties of the "
132                     "MethodParameters instance.") ]
133              CIM_ManagedElement REF ValueSource;
134           };
135           
136           
137           // ===================================================================
138           // ParametersForMethod
139           // ===================================================================
140              [Association, Version ("2.6.0"), Description (
141                  "ParametersForMethod represents the association between "
142                  "MethodParameters class(es) and a ManagedElement which has a "
143                  "method that may use the MethodParameters during its "
144                  "invocation.  This association is optional, as the Method "
145                  "Parameters instance may be passed as a parameter to a method "
146                  "or used to create a method signature before the method is "
147                  "invoked.  This association is useful for finding all the valid "
148 tony  1.1        "MethodParameters instances for a particular method.  It may be "
149                  "particularly useful for user-oriented interfaces and automated "
150                  "or policy driven method invocations.") ]
151           class CIM_ParametersForMethod {
152           
153                 [Key, Description (
154                     "The MethodParameters instance which may be used by the "
155                     "ParametersForMethod's method invocation.") ]
156              CIM_MethodParameters REF Parameters;
157           
158                 [Key, Description (
159                     "The ManagedElement which has a method that may use this "
160                     "instance of MethodParameters.") ]
161              CIM_ManagedElement REF TheMethod;
162           
163                 [Key, Description (
164                     "The name of the method that may use the referenced instance "
165                     "of MethodParameters during its invocation."), 
166                  MaxLen (64) ]
167              string MethodName;
168           };
169 tony  1.1 
170           
171           // ===================================================================
172           // end of file
173           // ===================================================================