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