White Papers

Version 1.2.3 53
1. RebootJobType: When provided in the input parameters, creates a specific reboot job to 888
“PowerCycle”, “
Graceful Reboot without forced shutdown”, or “Graceful Reboot with forced shutdown”. 889
This parameter only creates the RebootJob and does not schedule it. 890
2.
ScheduledStartTime: When provided in the input parameters, schedules the “configuration job” and the 891
optional “reboot job” at the specified start time. A special value of “TIME_NOW” schedules the job(s) 892
immediately. 893
3.
UntilTime: This parameter has a dependency on “ScheduledStartTime”, together “ScheduledStartTime” and 894
“UntilTime” define a time window for scheduling the job(s). Once scheduled, jobs will be executed within the 895
time window. 896
If CreateTargetedConfigJob method is executed without the three optional parameters discussed above, then 897
configuration job is created but not scheduled. However, this configuration job can be scheduled later using the 898
DCIM_JobService.SetupJobQueue () method from the “Job Control Profile”. DCIM_JobService.SetupJobQueue () 899
can be executed to schedule several configuration jobs including the reboot job. Refer to “Job Control Profile” for 900
more details. 901
Return code values for the CreateTargetedConfigJob() method are specified in Table 62, and parameters 902
are specified in Table 63. 903
Subsequent calls to CreateTargetedConfigJob after the first CreateTargetedConfigJob will result in error 904
until the first job is completed. 905
Table 62 – DCIM_NICService.CreateTargetedConfigJob() Method: Return Code Values 906
Value Description
2 Failed
4096
1
Job Created
1
Table 63 – DCIM_NICService.CreateTargetedConfigJob() Method: Parameters 907
Qualifiers Name Type Description/Values
IN, REQ Target String FQDD of the NIC
IN RebootJobType Uint16 Shall contain the requested reboot type:
• 1 - PowerCycle
• 2 - Graceful Reboot without forced
shutdown
• 3 - Graceful Reboot with forced
shutdown.
IN ScheduledStartTime String
Start time for the job execution in format:
yyyymmddhhmmss.
The string "TIME_NOW" means immediate.
IN UntilTime String
End time for the job execution in format:
yyyymmddhhmmss. :
If this parameter is not NULL, then
ScheduledStartTime parameter shall also be
specified.
OUT Job
1
CIM_ConcreteJob
REF
Reference to the newly created pending value
application job.
1
OUT MessageID String Error MessageID
OUT Message String Error Message
OUT MessageArguments[] String Error MessageArguments