1 tony 1.1 // ===================================================================
2 // Title: Core Power Management 2.8
3 // Filename: Core28_PowerMgmt.mof
4 // Version: 2.8
5 // Release: Preliminary
6 // Date: 05/22/2003
7 // ===================================================================
8 // Copyright 2002-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 concepts for power
46 // management.
47 //
48 // The object classes below are listed in an order that
49 // avoids forward references. Required objects, defined
50 // by other working groups, are omitted.
51 // ==================================================================
52 // Change Log for v2.8 Preliminary
53 // CR932 - Add power mode status to OperationalStatus.
54 // Move the specific power mode states from availability
55 // to a property between the PowerMgmt service and its ME.
56 // Remove the overlapping properties from Logical Device.
57 // CR950 - Add ArrayType to CIM_ManagedSystemElement properties
58 // CR1002 - Move the power on statistics to their own statistic class
59 // CR1019 - CIM Versioning for 2.8 Preliminary
60 //
61 // Change Log for v2.7 Final
62 // CR968 - Remove the Experimental qualifier
63 //
64 tony 1.1 // Change Log for v2.7
65 // CR720 - Introduce PowerManagementCapabilities &
66 // PowerManagementService
67 // ===================================================================
68
69 #pragma locale ("en_US")
70
71
72 // ===================================================================
73 // PowerManagementCapabilites
74 // ===================================================================
75 [Version ("2.7.0"), Description (
76 "A class derived from Capabilities that describes the power "
77 "management aspects of an element (typically a system or "
78 "device). The element's power management capabilities are "
79 "decoupled from a PowerManagementService, since a single "
80 "service could apply to multiple elements, each with specific "
81 "capabilities.") ]
82 class CIM_PowerManagementCapabilities : CIM_Capabilities {
83
84 [Description (
85 tony 1.1 "An enumeration indicating the specific power-related "
86 "capabilities of a managed element. Since this is an array, "
87 "multiple values may be specified. The current values in "
88 "the enumeration are:\n"
89 "0 = Unknown\n"
90 "1 = Other\n"
91 "2 = Power Saving Modes Entered Automatically, describing "
92 "that a managed element can change its power state based on "
93 "usage or other criteria\n"
94 "3 = Power State Settable, indicating that the SetPowerState "
95 "method is supported\n"
96 "4 = Power Cycling Supported, indicating that the "
97 "SetPowerState method can be invoked with the PowerState "
98 "input variable set to 'Power Cycle'\n"
99 "5 = Timed Power On Supported, indicating that the "
100 "SetPowerState method can be invoked with the PowerState "
101 "input variable set to 'Power Cycle' and the Time parameter "
102 "set to a specific date and time, or interval, for "
103 "power-on."),
104 ValueMap {"0", "1", "2", "3", "4", "5"},
105 Values {"Unknown", "Other",
106 tony 1.1 "Power Saving Modes Entered Automatically",
107 "Power State Settable", "Power Cycling Supported",
108 "Timed Power On Supported"},
109 MappingStrings {"MIF.DMTF|System Power Controls|001.2"},
110 ModelCorrespondence { "CIM_PowerManagementCapabilities."
111 "OtherPowerCapabilitiesDescriptions",
112 "CIM_PowerManagementService.SetPowerState"} ]
113 uint16 PowerCapabilities[];
114
115 [Description (
116 "An array of strings describing an element's additional "
117 "power management capabilities, used when the "
118 "PowerCapabilities array includes the value 1, \"Other\"."),
119 ModelCorrespondence {
120 "CIM_PowerManagementCapabilities.PowerCapabilities"} ]
121 string OtherPowerCapabilitiesDescriptions[];
122 };
123
124
125 // ===================================================================
126 // PowerManagementService
127 tony 1.1 // ===================================================================
128 [Version ("2.7.0"), Description (
129 "A class derived from Service that describes power management "
130 "functionality, hosted on a System. The fact that this service "
131 "may be used to affect the power state of a particular element "
132 "is defined by the CIM_ServiceAvailable ToElement association.") ]
133 class CIM_PowerManagementService : CIM_Service {
134
135 [Description (
136 "SetPowerState defines the desired power state of the "
137 "managed element, and when the element should be put into "
138 "that state. The SetPowerState method has three input "
139 "parameters, no output parameters, and a result.\n"
140 "- PowerState indicates the desired power state.\n"
141 "- ManagedElement indicates the element whose state is set. "
142 "This element SHOULD be associated to the service using the "
143 "ServiceAvailableToElement relationship.\n"
144 "- Time indicates when the power state should be set, either "
145 "as a regular date-time value or as an interval value (where "
146 "the interval begins when the method invocation is "
147 "received).\n"
148 tony 1.1 "Note that when the PowerState parameter is equal to 5, "
149 "\"Power Cycle\", the Time parameter indicates when the "
150 "managed element should powered on again. Power off is "
151 "immediate.\n"
152 "SetPowerState should return 0 if successful, 1 if the "
153 "specified State and Time request is not supported for the "
154 "element, and some other value if any other error occurred. "
155 "In a subclass, the set of possible return codes could be "
156 "specified, using a ValueMap qualifier on the method. The "
157 "strings to which the ValueMap contents are 'translated' may "
158 "also be specified in the subclass as a Values array "
159 "qualifier.") ]
160 uint32 SetPowerState(
161 [IN, ValueMap {"1", "2", "3", "4", "5", "6", "7", "8"},
162 Values {"Full Power", "Power Save - Low Power Mode",
163 "Power Save - Standby", "Power Save - Other",
164 "Power Cycle", "Power Off", "Hibernate", "Soft Off"}]
165 uint16 PowerState,
166 [IN] CIM_ManagedElement REF ManagedElement,
167 [IN] datetime Time);
168 };
169 tony 1.1
170 // ==================================================================
171 // AssociatedPowerManagementService
172 // ==================================================================
173 [Association, Experimental, Version ("2.7.1000"), Description (
174 "The assoication between a managed system element, and it's "
175 "power management service.") ]
176 class CIM_AssociatedPowerManagementService : CIM_ServiceAvailableToElement {
177
178 [Override ("ServiceProvided"), Max (1), Description (
179 "The Service that is available.") ]
180 CIM_PowerManagementService REF ServiceProvided;
181
182 [Description (
183 "The current power state of the associated Managed System "
184 "Element."),
185 ValueMap {"0", "1", "2", "3", "4", "5"},
186 Values {"Unknown", "Other",
187 "Power Saving Modes Entered Automatically",
188 "Power State Settable", "Power Cycling Supported",
189 "Timed Power On Supported"},
190 tony 1.1 MappingStrings {"MIF.DMTF|System Power Controls|001.2"},
191 ModelCorrespondence {
192 "CIM_PowerManagementCapabilities.PowerCapabilities"} ]
193 uint16 PowerState;
194
195 [Description (
196 "A string describing an element's additional power "
197 "management state, used when the PowerState is set to the "
198 "value 1, \"Other\"."),
199 ModelCorrespondence {
200 "CIM_AssociatedPowerManagementService.PowerState"} ]
201 string OtherPowerState;
202 };
203
204 // ==================================================================
205 // PoweredStatisticalData
206 // ==================================================================
207 [Experimental, Version ("2.7.1000"), Description (
208 "Statistical information related to the powered on time of a "
209 "Managed Element.") ]
210 class CIM_PoweredStatisticalData : CIM_StatisticalData {
211 tony 1.1
212 [Description (
213 "The amount of consecutive time that the managed element has "
214 "been powered on.") ]
215 datetime PowerOnHours;
216
217 [Description (
218 "The total amount of time that the managed element has been "
219 "powered on.") ]
220 datetime TotalPowerOnHours;
221 };
222
223 // ===================================================================
224 // end of file
225 // ===================================================================
|