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