White Papers

28 Version 1.2.0
444
8 Methods 445
This section details the requirements for supporting extrinsic methods for the CIM elements defined by 446
this profile. 447
8.1 DCIM_SystemManagementService.SetAttribute() 448
The SetAttribute( ) method is used to set or change the value of a system attribute. 449
Invocation of the SetAttribute( ) method shall change the value of the attribute’s CurrentValue or 450
attribute’s PendingValue property to the value specified by the AttributeValue parameter if the attribute’s 451
IsReadOnly property is FALSE. If this method is invoked when the attribute’s IsReadOnly property is 452
TRUE, it shall result in no change to the value of the attribute’s CurrentValue property. The result of 453
changing this value is described with the SetResult parameter. 454
Return code values for the SetAttribute() method are specified in Table 21 and parameters are specified 455
in Table 22. Invoking the SetAttribute( ) method multiple times can result in the earlier requests being 456
overwritten or lost. 457
Table 21SetAttribute() Method: Return Code Values 458
Value Description
0 Completed with no error
2 Failed
Table 22SetAttribute() Method: Parameters 459
Qualifiers Name Type Description/Values
IN, REQ Target String
Shall be set to “
System.Embedded.1
IN, REQ AttributeName String
Shall be the GroupID property value followed by “#”
character and then followed by the AttributeName property
value for the attribute to be modified.
Example: “ServerPwr.1#PowerCapSetting
IN, REQ AttributeValue[] String Shall contain the desired attribute value.
If the value is valid, the CurrentValue or PendingValue
property of the specified attribute will be modified.
OUT SetResult String Returns:
"Set CurrentValue property" when the attributes
current value is set.
“Set PendingValue property” when the attributes
pending value is set.
OUT RebootRequired String Returns:
“Yes” if reboot is required,
“No” if reboot is not required.
OUT MessageID String
Error Message ID may be used to look-up in the Dell
Message registry files. For more information, see Error
Message Registry
OUT Message String Error Message
OUT MessageArguments[] String Error MessageArguments