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