White Papers

22 Version 1.0.0
Qualifiers
Name
Type
Description/Values
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 MessageID
OUT
Message[]
String
Error Message
OUT
MessageArguments[]
String
Error MessageArguments
8.3 DCIM_NICService.CreateTargetedConfigJob()
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” or “Graceful Reboot without forced shutdown” or “Graceful Reboot with forced shutdown”.
This parameter only creates the RebootJob and does not schedule it.
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 3 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 () method from the “Job Control Profile”. DCIM_JobService.SetupJobQueue ()
can be executed to schedule several configuration jobs including the reboot job. Refer to “Job Control Profile” for
more details.
Return code values for the CreateTargetedConfigJob() method are specified in Table 22, and parameters
are specified in Table 23.
Subsequent calls to CreateTargetedConfigJob after the first CreateTargetedConfigJob will result in error
until the first job is completed.
Table 22 – CreateTargetedConfigJob() Method: Return Code Values
Value
Description
0
Success
1
Not supported
2
Failed
4096
Job Created