1 kumpf 1.2 // ===================================================================
2 // Title: Core Power Management 2.7
3 // Filename: Core27_PowerMgmt.mof
4 // Version: 2.7.0
5 // Release: Final
6 // Date: 03/31/03
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 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 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.7
53 // CR968 - Remove the Experimental qualifier
54 //
55 // Change Log for v2.7
56 // CR720 - Introduce PowerManagementCapabilities &
57 // PowerManagementService
58 // ===================================================================
59
60 #pragma locale ("en_US")
61
62
63 // ===================================================================
64 kumpf 1.2 // PowerManagementCapabilites
65 // ===================================================================
66 [Version ("2.7.0"), Description (
67 "A class derived from Capabilities that describes the power "
68 "management aspects of an element (typically a system or device). "
69 "The element's power management capabilities are decoupled from "
70 "a PowerManagementService, since a single service could "
71 "apply to multiple elements, each with specific capabilities." ) ]
72 class CIM_PowerManagementCapabilities : CIM_Capabilities {
73
74 [Description (
75 "An enumeration indicating the specific power-related "
76 "capabilities of a managed element. Since this is an array, "
77 "multiple values may be specified. The current values in "
78 "the enumeration are: \n"
79 "0 = Unknown \n"
80 "1 = Other \n"
81 "2 = Power Saving Modes Entered Automatically, describing "
82 "that a managed element can change its power state based on "
83 "usage or other criteria \n"
84 "3 = Power State Settable, indicating that the SetPowerState "
85 kumpf 1.2 "method is supported \n"
86 "4 = Power Cycling Supported, indicating that the "
87 "SetPowerState method can be invoked with the PowerState "
88 "input variable set to 'Power Cycle' \n"
89 "5 = Timed Power On Supported, indicating that the "
90 "SetPowerState method can be invoked with the PowerState "
91 "input variable set to 'Power Cycle' and the Time parameter "
92 "set to a specific date and time, or interval, for power-on."),
93 ValueMap {"0", "1", "2", "3", "4", "5"},
94 Values {"Unknown", "Other",
95 "Power Saving Modes Entered Automatically",
96 "Power State Settable", "Power Cycling Supported",
97 "Timed Power On Supported"},
98 MappingStrings {"MIF.DMTF|System Power Controls|001.2"},
99 ModelCorrespondence {
100 "CIM_PowerManagementCapabilities."
101 "OtherPowerCapabilitiesDescriptions",
102 "CIM_PowerManagementService.SetPowerState"} ]
103 uint16 PowerCapabilities[];
104
105 [Description (
106 kumpf 1.2 "An array of strings describing an element's additional power "
107 "management capabilities, used when the PowerCapabilities "
108 "array includes the value 1, \"Other\"."),
109 ModelCorrespondence {
110 "CIM_PowerManagementCapabilities.PowerCapabilities"} ]
111 string OtherPowerCapabilitiesDescriptions[];
112 };
113
114
115 // ===================================================================
116 // PowerManagementService
117 // ===================================================================
118 [Version ("2.7.0"), Description (
119 "A class derived from Service that describes power "
120 "management functionality, hosted on a System. The fact "
121 "that this service may be used to affect the power state "
122 "of a particular element is defined by the CIM_ServiceAvailable"
123 "ToElement association." ) ]
124 class CIM_PowerManagementService : CIM_Service {
125
126 [Description(
127 kumpf 1.2 " SetPowerState defines the desired power state of the "
128 "managed element, and when the element should be put into "
129 "that state. The SetPowerState method has three input "
130 "parameters, no output parameters, and a result. \n"
131 " - PowerState indicates the desired power state. \n"
132 " - ManagedElement indicates the element whose state "
133 "is set. This element SHOULD be associated to the "
134 "service using the ServiceAvailableToElement relationship. \n"
135 " - Time indicates when the power state should be set, "
136 "either as a regular date-time value or as an interval "
137 "value (where the interval begins when the "
138 "method invocation is received). \n"
139 "Note that when the PowerState parameter is equal to "
140 "5, \"Power Cycle\", the Time parameter indicates "
141 "when the managed element should "
142 "powered on again. Power off is immediate. \n"
143 " SetPowerState should return 0 if successful, 1 if the "
144 "specified State and Time request is not supported for "
145 "the element, and some other value if any other error "
146 "occurred. In a subclass, the set of possible return codes "
147 "could be specified, using a ValueMap qualifier on the "
148 kumpf 1.2 "method. The strings to which the ValueMap contents "
149 "are 'translated' may also be specified in "
150 "the subclass as a Values array qualifier.") ]
151 uint32 SetPowerState(
152 [IN, ValueMap {"1", "2", "3", "4", "5", "6", "7", "8"},
153 Values {"Full Power", "Power Save - Low Power Mode",
154 "Power Save - Standby", "Power Save - Other",
155 "Power Cycle", "Power Off", "Hibernate", "Soft Off"}]
156 uint16 PowerState,
157 [IN] CIM_ManagedElement REF ManagedElement,
158 [IN] datetime Time);
159 };
160
161
162 // ===================================================================
163 // end of file
164 // ===================================================================
|