Reference Guide

73 Lifecycle Controller Web Services Interface Guide for Linux
10 Job Control Management
10.1 Description of Job Management
The Dell Common Information Model (CIM) class extensions for supporting update and attribute
configuration job control are defined in the Dell Job Control Profile
2
and related MOF files
3
. The diagrams
representing the classes that are implemented by the Lifecycle Controller firmware can also be found in
Dell Job Control Profile.
Profile and Associated MOFs:
http://www.delltechcenter.com/page/DCIM.Library.Profile
10.2 Remote Job Control Examples
10.2.1 Setup Job Queue
The SetupJobQueue() method takes in an array of jobids and schedules them to run immediately or at a
later time. The jobids are acquired using enumerating DCIM_LifecycleJob as described in Section 10.2.3.
When there is a Reboot Job, in a job array that contains multiple jobs, the System will reboot the UEFI
(Unified Extensible Firmware Interface) at the scheduled time.
Invoke SetupJobQueue() with the following parameters and syntax:
JobArray: The jobids are listed in the JobArray element. Multiple jobs are listed in the order of job
execution sequence. If a System is to reboot at the scheduled start time, a reboot job will need to be
added to the list. This reboot job has a prefix of RID_ for its jobid.
Note: Scheduling a job that is already scheduled will display a message indicating an error.
If there is no reboot job in the job array, the System will schedule the jobs for execution at the specified
start time. The jobs will not be executed until the System is rebooted by something other than Lifecycle
Controller. At the specified UntilTime, any jobs that have not been executed are failed with an error
indicating that the job was not executed in the specified maintenance window. For some component
updates such as Diagnostics, USC, and iDRAC firmware, a System reboot is not needed.
EXAMPLE:
wsman invoke -a SetupJobQueue
http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_JobService?
SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_JobService,
SystemName=Idrac,Name=JobService
-h $IPADDRESS -V -v -c dummy.cert -P 443
-u $USERNAME -p $PASSWORD
-J SetupJobQueue.xml
-j utf-8 -y basic
The syntax for SetupJobQueue.xml is:
<p:SetupJobQueue_INPUT
xmlns:p="http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_JobSe
rvice">
<p:JobArray>JID_001249463339</p:JobArray>
<p:JobArray>RID_001265817718</p:JobArray>
<p:StartTimeInterval>TIME_NOW</p:StartTimeInterval>
<p:UntilTime>20100730121500</p:UntilTime>
</p:SetupJobQueue_INPUT>