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