White Papers

22 Version 1.1.0
 A value of 3 (Disabled) shall correspond to a request to power off the system.
431
 A value of 11 (Reset) shall correspond to a request to power cycle the system.
432
The method shall be successful, if upon the completion of the method the system has been requested to
433
transition to the desired state indicated by the RequestedState parameter. An actual change in the state
434
may not occur, even if the the method was executed sucessfully. The EnabledState property shall
435
indicate the current state of the system.
436
Detailed requirements of the RequestStateChange() method are specified in Table 21 and Table 22.
437
Invoking the DCIM_ComputerSystem.RequestStateChange() method multiple times could result in earlier
438
requests being overwritten or lost.
439
Table 21 – DCIM_ComputerSystem.RequestStateChange( ) Method: Return Code Values
440
Value
Description
0
Request was successfully executed.
2
Error occurred
Table 22 – DCIM_ComputerSystem.RequestStateChange( ) Method: Parameters
441
Qualifiers
Name
Type
Description/Values
IN, REQ
RequestedState
uint16
Valid state values :
2 (Enabled)
3 (Disabled)
11 (Reset)
OUT
MessageID
string
Error Message ID- can be used to index into
Dell Message registry files
OUT
Message
string
Error Message in English corresponding to
MessageID is returned if the method fails to
execute
OUT
MessageArguments[]
string
Substitution variables for dynamic error
messages
Table 23 – DCIM_ComputerSystem.RequestStateChange( ) Method: Standard Messages
442
MessageID (OUT parameter)
Message
MessageArguments[]
SYS002
The command failed
SYS003
Missing parameter(s) %s
RequestedState
SYS004
Invalid parameter value for %s
RequestedState
SYS021
The command failed to set %s
RequestedState
8.1.1 DCIM_ComputerSystem.RequestStateChange( ) Conditional Support
443
When the DCIM_CSEnabledLogicalElementCapabilities.RequestedStatesSupported property contains at
444
least one value, the DCIM_ComputerSystem.RequestStateChange() method shall be implemented and
445
supported. The DCIM_ComputerSystem.RequestStateChange() method shall not return a value of 1 (Not
446
Supported).
447