White Papers

Version 1.3.0 55
8.7 DCIM_BootConfigSetting.ChangeBootOrderByInstanceID()
656
The ChangeBootOrderByInstanceID( ) method is used to change the order of boot devices within the boot
657
list.
658
Invoking the ChangeBootOrderByInstanceID() method shall order the boot devices in the list in
659
accordance to the corresponding array element in the Source parameter array. The omitted boot devices
660
in the Source parameter array shall be omitted in the boot list ordering.
661
Each element of the Source parameter array shall have value of a DCIM_BootSourceSetting.InstanceID
662
property.
663
Upon successful completion of this method, the value of the PendingAssignedSequence property on each
664
instance of CIM_BootSourceSetting shall be updated such that the values are monotonically increasing in
665
correlation with the position the “source” input parameter array. That is, the first position in the array shall
666
have the lowest non-zero value for PendingAssignedSequence. The second position will have the second
667
lowest value, and so on.
668
Upon successful completion of this method, the value of the PendingAssignedSequence property on each
669
instance of DCIM_BootSourceSetting, that relates to the target DCIM_BootConfigSetting instance that is
670
not present in the input array, shall be assigned a value of 0.
671
NOTE: Invoking the ChangeBootOrderByInstanceID( ) method multiple times can result in the earlier
672
requests being overwritten or lost.
673
Upon the successful completion of the returned job, the CurrentAssignedSequence shall have the same
674
value as the PendingAssignedSequence.
675
Return code values for the ChangeBootOrderByInstanceID() method are specified in Table 58 and
676
parameters are specified in Table 59.
677
Table 58 – ChangeBootOrderByInstanceID() Method: Return Code Values
678
Value
Description
0
Completed with no error
1
Not Supported
2
Failed
4096
1
Job Created
1
Table 59 – ChangeBootOrderByInstanceID() Method: Parameters
679
Qualifiers
Name
Type
Description/Values
IN, REQ
source[]
String
Shall contain the InstanceID value(s) for
DCIM_BootSourceSetting instances to change the order
of.
OUT
MessageID
String
Error MessageID
OUT
Message
String
Error Message
OUT
MessageArguments[]
String
Error MessageArguments
NOTE: 1 – 4096(Job Created) shall be returned, only and only if the soure parameter array contains boot source
680
reference for an unattached vFlash partition. If return code is 4096 (Job Created), the newly created job does not
681
execute if the LC core services are not running. Verify that DCIM_LCEnumeration with AttributeName equal to
682
“LifecycleControllerState” has the CurrentValue property equal to “Enabled”. For more information, see DCIM LC
683
Management Profile.
684
685