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