gov.bnl.star.offline.scheduler
Interface Dispatcher

All Known Implementing Classes:

BOSSDispatcher, CompositeDispatcher, CondorDispatcher, CondorGRSLDispatcher, GenericCompositeDispatcher, LocalDispatcher, LSFDispatcher, PBSDispatcher, SGEDispatcher, XgridDispatcher

public interface Dispatcher

Allows to dispatch a job to a remote machine and to retrieve it's output.

Version:

$Revision: 1.16 $ $Date: 2006/11/21 00:41:32 $

Author:

Gabriele Carcassi

Method Summary

void	dispatch(Request request, java.util.List jobs) Dispatches the processes described in the job request.
void	Kill(Request request, java.util.List jobs) Kills the processes associated with this job.
void	retrieveOutput(Request job, java.util.List jobs) Retrieves the output of the job from the target machine.
java.lang.String	Status(Job job, int Processe) Returns The status of the job
void	stop() Cases the dispacher to stop dispaching and trys to kill dispached jobs This is currently not implemented by any dispatchers.
boolean	test(Queue queue) Runs test(s) on underlying components to determine if submitting jobs should be attempted.

Method Detail

dispatch

void dispatch(Request request,
              java.util.List jobs)

Dispatches the processes described in the job request. To dispatch the job, the dispatcher will also recreate the remote environment needed by the job as specified in the JobDescription

Parameters:

request - job description and requirements, include input and output file and environment variables

retrieveOutput

void retrieveOutput(Request job,
                    java.util.List jobs)

Retrieves the output of the job from the target machine. It will first check whether the job has terminated, and than it will retrieve the output files and delete any temporary files on the target machine.

Parameters:

job - job description and requirements, include input and output file and environment variables

Kill

void Kill(Request request,
          java.util.List jobs)

Kills the processes associated with this job.

Status

java.lang.String Status(Job job,
                        int Processe)

Returns The status of the job

stop

void stop()

Cases the dispacher to stop dispaching and trys to kill dispached jobs This is currently not implemented by any dispatchers.

test

boolean test(Queue queue)

Runs test(s) on underlying components to determine if submitting jobs should be attempted. Will return true to indicate everything is alright and false if the test has failed.