White Papers

36 Version 1.1.0
8.7 DCIM_BootConfigSetting.ChangeBootOrderByInstanceID() 487
The ChangeBootOrderByInstanceID( ) method is used to change the order of boot devices within the boot 488
list. 489
The successful invocation of the ChangeBootOrderByInstanceID() method shall order the boot devices in 490
the list in accordance to the corresponding array element in the “source” parameter array. The omitted 491
boot devices in the “source” parameter array shall be omitted in the boot list ordering. 492
Each element of the “source” parameter array shall have value of a DCIM_BootSourceSetting.InstanceID 493
property. 494
Upon successful completion of this method, the value of the PendingAssignedSequence property on each 495
instance of CIM_BootSourceSetting shall be updated such that the values are monotonically increasing in 496
correlation with the position of the referenced DCIM_BootSourceSetting instance in the “source” input 497
parameter array. That is, the first position in the array shall have the lowest non-zero value for 498
PendingAssignedSequence. The second position will have the second lowest value, and so on. 499
Upon successful completion of this method, the value of the PendingAssignedSequence property on each 500
instance of DCIM_BootSourceSetting, that relates to the target DCIM_BootConfigSetting instance that is 501
not present in the input array, shall be assigned a value of 0. 502
Upon the successful completion of the returned job, the CurrentAssignedSequence shall have the same 503
value as the PendingAssignedSequence. 504
Return code values for the ChangeBootOrderByInstanceID( ) method are specified in Table 31 and 505
parameters are specified in Table 32. Invoking the ChangeBootOrderByInstanceID( ) method multiple 506
times can result in the earlier requests being overwritten or lost. 507
Table 31 – ChangeBootOrderByInstanceID() Method: Return Code Values 508
Value
Description
0
Completed with no error
1
Not supported
2
Failed
4096
Job Created
Table 32 – ChangeBootOrderByInstanceID() Method: Parameters 509
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
Job
CIM_Concrete
Job REF
Reference to the newly created pending value application
job.
OUT
MessageID
String
Error MessageID
OUT
Message
String
Error Message
OUT
MessageArguments[]
String
Error MessageArguments
510
9 Use Cases 511
This section contains use cases for the Dell BIOS and Boot Profile. 512