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