// Copyright (c) 2007-2010, Intel Corporation. All rights reserved. 
   [Version ( "10.0" ), 
    Description ( 
       "The IPS_PowerManagementService inherits "
       "CIM_PowerManagementService and adds capability "
       "to control OS power state"	   )]
class IPS_PowerManagementService : CIM_Service {



      [Description ( 
          "RequestOSPowerSavingStateChange defines the desired OS power"    
          "saving state of the managed element, and when the element" 
          " should be put into that state. The "  
          "RequestOSPowerSavingStateChange method has xxx input " 
          " parameters and a result code. \n"
          "- OSPowerSavingState indicates the desired OS power saving " 
          "state. \n"
          "- ManagedElement indicates the element whose OS state is "
          "set. This element SHOULD be associated to the service "
          "using the AssociatedPowerManagementService "
          "relationship. \n"
          "- Time indicates when the OS power saving state should be"  
          " set, either as a regular date-time value or as an " 
          " interval value (where the interval begins when the "
          "method invocation is received). \n"
          "- Job is a reference to the job if started. \n"
          "- TimeOutPeriod indicates the maximum amount of time a "
          "client expects the transition to take. \n" ), 
       ValueMap { "0", "1", "2", "3", "4", "5", "6", "..", "4096", 
          "4097", "4098", "4099", "4100..32767", "32768..65535" }, 
       Values { "Completed with No Error", "Not Supported", 
          "Unknown or Unspecified Error", 
          "Cannot complete within Timeout Period", "Failed", 
          "Invalid Parameter", "In Use", "DMTF Reserved", 
          "Method Parameters Checked - Job Started", 
          "Invalid State Transition", 
          "Use of Timeout Parameter Not Supported", "Busy", 
          "Method Reserved", "Vendor Specific" }]
   uint32 RequestOSPowerSavingStateChange(
         [IN, Description ( "The OS power saving state for "  
             "ManagedElement." ), 
              ValueMap { "2", "3", "..", "0x7FFF..0xFFFF" }, 
              Values { "Full Power", "OS power saving", 
              "DMTF Reserved", "Vendor Specific" }]
      uint16 OSPowerSavingState, 
         [IN, Description ( 
             "ManagedElement indicates the element whose state is set."
              )]
      CIM_ManagedElement REF ManagedElement, 
         [IN, Description ( 
             "Time indicates when the OS power saving state should "
             "be set, either as a regular date-time value or as an "
             "interval value (where the interval begins when the "
             "method invocation is received." )]
      datetime Time, 
         [IN ( false ), OUT, Description ( 
             "Reference to the job (can be null if the task is completed)."
              )]
      CIM_ConcreteJob REF Job, 
         [IN, Description ( 
             "A timeout period that specifies the maximum amount "
             "of time that the client expects the transition to "
             "the new state to take. The interval format must be "
             "used to specify the TimeoutPeriod. A value of 0 or "
             "a null parameter indicates that the client has no "
             "time requirements for the transition. \n"
             "If this property does not contain 0 or null and "
             "the implementation does not support this "
             "parameter, a return code of \'Use Of Timeout "
             "Parameter Not Supported\' must be returned." )]
      datetime TimeoutPeriod);
      


      [Description ( 
          "The current operating system power saving state of the " 	                  
          "associated Managed System Element." ), 
       ValueMap { "0", "1", "2", "3", "..", "0x7FFF..0xFFFF" }, 
       Values { "Unknown", "Unsupported", "Full Power", 
          "OS power saving", "DMTF Reserved", 
          "Vendor Specific" }, 
       ModelCorrespondence { 
          "CIM_PowerManagementCapabilities.OSPowerSavingStateSupported",
"CIM_AssociatedPowerManagementService.PowerState" }]
   uint16 OSPowerSavingState;


};