org.astrogrid.jes.delegate
Interface JobController

All Superinterfaces:

Delegate

All Known Implementing Classes:

JobControllerDelegate

public interface JobController

extends Delegate

Interface to a service for managing jobs - listing, deleting, submitting for execution, etc.

same as axis-generated service interface, but with castor types instead

Author:

Noel Winstanley nw@jb.man.ac.uk 06-Feb-2004

Field Summary

Fields inherited from interface org.astrogrid.jes.delegate.Delegate

TEST_URI

Method Summary

void	cancelJob(JobURN urn) cancel the execution of a job
void	deleteJob(JobURN urn) delete all record of a job
WorkflowSummaryType[]	listJobs(Account acc) retreive a list of all jobs (pending, runing and completed) for a particylar user
Workflow	readJob(JobURN urn) retrive the workflow document for a job.
JobSummary[]	readJobList(Account acc) Deprecated. - use listJobs(org.astrogrid.community.beans.v1.Account)
JobURN	submitWorkflow(Workflow wf) submit a workflow document for execution as a new job

Methods inherited from interface org.astrogrid.jes.delegate.Delegate

getTargetEndPoint, getTimeout, setTimeout

Method Detail

submitWorkflow

public JobURN submitWorkflow(Workflow wf)
                      throws JesDelegateException

submit a workflow document for execution as a new job

Parameters:

wf - workflow to execute

Returns:

a unique identifier for this job

Throws:

JesDelegateException

cancelJob

public void cancelJob(JobURN urn)
               throws JesDelegateException

cancel the execution of a job

Parameters:

urn - unique identifier of the job to cancel

Throws:

JesDelegateException

deleteJob

public void deleteJob(JobURN urn)
               throws JesDelegateException

delete all record of a job

Parameters:

urn - unique identifier of the job to delete

Throws:

JesDelegateException

readJobList

public JobSummary[] readJobList(Account acc)
                         throws JesDelegateException

Deprecated. - use listJobs(org.astrogrid.community.beans.v1.Account)

retreive a list of all jobs (pending, running and completed) for a particular user

Parameters:

acc - account object for the user in question

Returns:

array of job summary objects, one summary for each job the user has in the system

Throws:

JesDelegateException

listJobs

public WorkflowSummaryType[] listJobs(Account acc)
                               throws JesDelegateException

retreive a list of all jobs (pending, runing and completed) for a particylar user

Throws:

JesDelegateException

readJob

public Workflow readJob(JobURN urn)
                 throws JesDelegateException

retrive the workflow document for a job.

Parameters:

urn - unique identifier for a job.

Returns:

annotated workflow document - will contains details of step execution, etc.

Throws:

JesDelegateException