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