|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Job
A Job
is a real computational task that is executed on a compute
resources. The distinctive properties are that it can be started with files
that can be imported before execution, it has a working directory, stdout,
stderr, and an exit status.
Method Summary | |
---|---|
List<SimpleTransfer> |
cleanup(File... exports)
Export files from the working directory of the Job and remove it
from its Site . |
int |
getExitCode()
The exit code of the Job . |
String |
getLog()
A log, if provided by the implementation. |
Site |
getSite()
The Site that this Job is executed at. |
File |
getStdErr()
A reference to the File representing stderr
in the working directory of the Job . |
File |
getStdOut()
A reference to the File representing stdout
in the working directory of the Job . |
Calendar |
getSubmissionTime()
|
String |
getTaskName()
Name of the Job , potentially more descriptive than its id, but
may be mapped to its id by an implementation. |
File |
getWorkingDirectory()
The browsable working directory of a Job . |
void |
hold()
Hold the job. |
void |
resume()
Resume a held job. |
void |
startASync(File... imports)
This method is essentially the same as startSync(File...) ,
except that it returns immediately and executes the Task in the
background. |
TaskStatus |
startASync(StatusChangeListener listener,
File... imports)
This method is similar to startASync(File...) , but an additional
parameter allows to provide a StatusChangeListener that is
interested in receiving notifications of changes of the
TaskStatus . |
TaskStatus |
startSync(File... imports)
Synchronous start of the task. |
Methods inherited from interface eu.unicore.hila.grid.Task |
---|
abort, block, block, getError, getHistory, getId, registerStatusChangeListener, removeStatusChangeListener, status |
Methods inherited from interface eu.unicore.hila.Resource |
---|
getChild, getChildren, getLocation, getMetadata, getName, getParent, ok |
Method Detail |
---|
TaskStatus startSync(File... imports) throws eu.unicore.hila.exceptions.HiLAException
Task
is in a final state (TaskStatus.SUCCESSFUL
,
TaskStatus.ABORTED
, TaskStatus.FAILED
). File
s to
be imported into the working directory before execution can be given as
arguments.
imports
- File
s to be imported into the Job
's working
directory before starting the execution.
TaskStatus
at the end of execution.
eu.unicore.hila.exceptions.HiLAException
void startASync(File... imports) throws eu.unicore.hila.exceptions.HiLAException
startSync(File...)
,
except that it returns immediately and executes the Task
in the
background.
imports
- File
s to be imported into the Job
's working
directory before starting the execution.
eu.unicore.hila.exceptions.HiLAException
TaskStatus startASync(StatusChangeListener listener, File... imports) throws eu.unicore.hila.exceptions.HiLAException
startASync(File...)
, but an additional
parameter allows to provide a StatusChangeListener
that is
interested in receiving notifications of changes of the
TaskStatus
.
listener
- A StatusChangeListener
interested in status changes of
the Task
imports
- File
s to be imported into the Job
's working
directory before starting the execution.
TaskStatus
at the time the method returns, this is not
necessarily a final state
eu.unicore.hila.exceptions.HiLAException
List<SimpleTransfer> cleanup(File... exports) throws eu.unicore.hila.exceptions.HiLAException
Job
and remove it
from its Site
.
exports
- File
s to be exported before removing the Job
from the Site
.
List
of SimpleTransfer
representing the exports.
eu.unicore.hila.exceptions.HiLAException
int getExitCode() throws eu.unicore.hila.exceptions.HiLAException
Job
.
eu.unicore.hila.exceptions.HiLAException
String getLog() throws eu.unicore.hila.exceptions.HiLAException
eu.unicore.hila.exceptions.HiLAException
Site getSite() throws eu.unicore.hila.exceptions.HiLAException
Site
that this Job
is executed at.
eu.unicore.hila.exceptions.HiLAException
File getStdErr() throws eu.unicore.hila.exceptions.HiLAException
File
representing stderr
in the working directory of the Job
.
eu.unicore.hila.exceptions.HiLAException
File getStdOut() throws eu.unicore.hila.exceptions.HiLAException
File
representing stdout
in the working directory of the Job
.
eu.unicore.hila.exceptions.HiLAException
Calendar getSubmissionTime() throws eu.unicore.hila.exceptions.HiLAException
Calendar
object representing the point in time when the
job has been submitted.
eu.unicore.hila.exceptions.HiLAException
String getTaskName() throws eu.unicore.hila.exceptions.HiLAException
Job
, potentially more descriptive than its id, but
may be mapped to its id by an implementation.
eu.unicore.hila.exceptions.HiLAException
File getWorkingDirectory() throws eu.unicore.hila.exceptions.HiLAException
Job
. It should be available
as soon as the Job
has been created.
eu.unicore.hila.exceptions.HiLAException
void hold() throws eu.unicore.hila.exceptions.HiLAException
eu.unicore.hila.exceptions.HiLAException
- Will be thrown, if the implementation or underlying systems
don't support this operation.void resume() throws eu.unicore.hila.exceptions.HiLAException
eu.unicore.hila.exceptions.HiLAException
- Will be thrown, if the implementation or underlying systems
don't support this operation.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |