White Papers
Table Of Contents
- 1 Scope
- 2 Normative References
- 3 Terms and Definitions
- 4 Symbols and Abbreviated Terms
- 5 Synopsis
- 6 Description
- 7 Implementation Description
- 8 Methods
- Table 29 – DCIM_FCService.SetAttribute() Method: Return Code Values
- The SetAttributes() method is used to set or change the values of a group of attributes.
- Table 32 – DCIM_FCService.SetAttributes() Method: Return Code Values
- The CreateTargetedConfigJob() method is used to apply the pending values created by the SetAttribute and SetAttributes methods. The successful execution of this method creates a job for application of pending attribute values.
- CreateTargetedConfigJob method supports the following optional input parameters
- 1. RebootJobType: When provided in the input parameters, creates a specific reboot job to “PowerCycle”, “Graceful Reboot without forced shutdown”, or “Graceful Reboot with forced shutdown”. This parameter only creates the RebootJob and does not schedu...
- 2. ScheduledStartTime: When provided in the input parameters, schedules the “configuration job” and the optional “reboot job” at the specified start time. A special value of “TIME_NOW” schedules the job(s) immediately.
- 3. UntilTime: This parameter has a dependency on “ScheduledStartTime”, together “ScheduledStartTime” and “UntilTime” define a time window for scheduling the job(s). Once scheduled, jobs will be executed within the time window.
- If CreateTargetedConfigJob method is executed without the three optional parameters discussed above, then configuration job is created but not scheduled. However, this configuration job can be scheduled later using the DCIM_JobService.SetupJobQueue ()...
- Table 35 – DCIM_FCService.CreateTargetedConfigJob() Method: Return Code Values
- Table 38 – DCIM_FCService.DeletePendingConfiguration() Method: Return Code Values
- 9 Use Cases
- 10 CIM Elements
- 11 Privilege and License Requirement
Version 1.0.0 33
MessageID (OUT parameter)
Message
MessageArguments[]
FC011
Configuration job already created,
pending data cannot be deleted
FC012
No pending data present to delete
FC013
Invalid AttributeName <parameter
name>
AttributeName
FC014
Invalid AttributeValue for
AttributeName <parameter name>
AttributeName
FC015
AttributeValue cannot be changed for
read only AttributeName <parameter
name>
AttributeName
FC016
AttributeValue cannot be changed for
disabled AttributeName <parameter
name>
AttributeName
FC017
Cannot perform the operation due to
an unknown error in iDRAC
FC018
Set operation failed as the attribute is
read only.
LC062
An instance of Export or Import
System Configuration is already
running.
590
8.2 DCIM_FCService.SetAttributes()
591
The SetAttributes( ) method is used to set or change the values of a group of attributes.
592
Successful SetAttributes( ) method invocation shall change the values of the CurrentValue or
593
PendingValue properties of the DCIM_FCAttribute instance that correspond to the names specified by the
594
AttributeName parameter, with the values specified by the AttributeValue parameter.
595
If the respective DCIM_FCAttribute.IsReadOnly property is TRUE, the method invocation shall fail and
596
shall result in no change to the corresponding value of the DCIM_FCAttribute.CurrentValue property.
597
Return code values for the SetAttributes( ) method are specified in Table 32, and parameters are
598
specified in Table 33.
599
Invoking the SetAttributes( ) method multiple times can result in the earlier requests being overwritten or
600
lost.
601
Table 32 – DCIM_FCService.SetAttributes() Method: Return Code Values
602
Value
Description
0
Completed with no error
2
Failed
Table 33 – DCIM_FCService.SetAttributes() Method: Parameters
603
Qualifiers
Name
Type
Description/Values
IN, REQ
Target
String
FQDD of the FC
IN, REQ
AttributeName[]
String
Shall contain an array of the AttributeName
property values for the attributes to be modified.