1 kumpf 1.2 // ===================================================================
2 // Title: Core Method Parameters 2.7
3 // Filename: Core27_MethodParms.mof
4 // Version: 2.7.0
5 // Release: Final
6 // Date: 03/31/03
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 kumpf 1.2 // 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 kumpf 1.2 // ===================================================================
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 kumpf 1.2 "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 kumpf 1.2 "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 kumpf 1.2 "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 kumpf 1.2 [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 kumpf 1.2 "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 kumpf 1.2 // ===================================================================
|