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.



Copyright © 2002-2004 STAR collaboration - Brookhaven National Laboratory. All Rights Reserved.