VERSION 12.0.871 |
|
5 Managing JobsYou can view and manage jobs using the JOBS page on the HQueue web interface. At the top of the page is a list of running jobs and on the bottom is a list of the most recently completed jobs. Here is a summary of the columns in each of the job lists:
5.1 Job View PagesA job view page has indepth information about a specific job. Job DetailsThis section has information about the job itself. It displays the following properties:
The Properties DialogSee 8.4 Job Properties for details on normal job properties. The table also displays the following additional properties:
Child JobsThis section holds all of the jobs that are a child of this job. See 5 Managing Jobs for more information on the contents of the tables. NotesThis section holds information on the note thread associated with the job. See 7 Managing Note Threads for more information on note threads. 5.2 Submitting JobsTo submit jobs from Houdini, please read 3 How to Submit Jobs . Submitting Jobs from the Python APIYou can also submit jobs via a Python script. Below is an example:
import xmlrpclib
# Connect to the HQueue server. hq_server = xmlrpclib.ServerProxy("http://hq_server_hostname:5000") # Define a job which prints "Hello World!". job_spec = { "name": "Print Hello World", "shell": "bash", "command": "echo 'Hello World!'" } # Submit the job to the server. # newjob() returns a list of job ids (in case multiple jobs are passed in at once). job_ids = hq_server.newjob(job_spec) # Query the job's status. status = hq_server.getstatus(job_ids[0]) print "Status: ", status For more information on scripting with HQueue, refer to the 12 Python API documentation. 5.3 Rescheduling JobsTo reschedule a job, go to the JOBS page, check the box for the target job and then click on the 'Reschedule' button located below the job list. You can reschedule several jobs at once by checking multiple boxes in the list. When a job is rescheduled, it is put back on the scheduling queue where it waits for an available client machine. Rescheduling a job also reschedules its parent jobs and any failed child jobs. Note that you cannot reschedule jobs that are running. To reschedule only failed, abandoned or cancelled jobs, click on the 'Reschedule Failed Jobs' button. 5.4 Cancelling JobsTo cancel a job, go to the JOBS page, check the box for the target job and then click on the 'Cancel' button located below the job list. You can cancel several jobs at once by checking multiple boxes in the list. When a job is cancelled, it is immediately removed from the scheduling queue and is terminated on the assigned client machine (if any). Cancelling a job also cancels its child jobs. Note that only running jobs can be cancelled. 5.5 Pausing JobsTo pause a job, go to the JOBS page, check the box for the target job and then click on the 'Pause' button located below the job list. You can pause several jobs at once by checking multiple boxes in the list. When a job is paused, its execution on the assigned client machine (if any) is halted. The job remains in the scheduling queue where it waits for the user to either resume or cancel it. Pausing a job also pauses its child jobs. Note that only unfinished jobs can be paused. 5.6 Resuming JobsTo resume a job, go to the JOBS page, check the box for the target job and then click on the 'Resume' button located below the job list. You can resume several jobs at once by checking multiple boxes in the list. When a job is resumed, its execution on the assigned client machine (if any) is reactivated. Resuming a job also resumes its child jobs. Note that only paused jobs can be resumed. 5.7 Deleting JobsTo delete a job, go to the JOBS page, check the box for the target job and then click on the 'Delete' button located below the job list. You can delete several jobs at once by checking multiple boxes in the list. When a job is deleted, it is permanently removed from the database. Deleting a job also deletes its child jobs. Note that only completed jobs can be deleted.
|