Package org.ogf.saga.job

The job package describes the API for submitting jobs to a grid resource.

See: Description

Interface Summary

Interface	Description
Job	Jobs are created by a JobService, using a JobDescription.
JobDescription	The contents of a job description is defined by its attributes.
JobSelf	A JobSelf is a Job that represents the current application, and is steerable.
JobService	A JobService represents a resource management back-end.

Class Summary

Class	Description
JobFactory	Factory for objects from the job package.

Package org.ogf.saga.job Description

The job package describes the API for submitting jobs to a grid resource. It has four interfaces: JobDescription, JobService, Job, and JobSelf. A JobDescription encapsulates a set of attributes that together describe a job that is to be submitted to a grid resource. A JobService is responsible for submitting the job. When a job is submitted successfully, a Job is returned, which provides handles for monitoring, actually running, waiting for it to finish. Finally, a JobSelf represents an application instance running under the management of a resource manager. It is a job, but also implements the Steerable interface.

An important deviation from the language-independent SAGA specifications is that the JobService.runJob method is specified differently: the input, output and error stream OUT parameters are not specified here, since Java has no OUT parameters. Unfortunately, their absence, according to the SAGA specifications, implies a non-interactive job. Since interactive jobs should still be supported, a parameter is added here to specify whether the job is interactive. If interactive, the streams can be obtained from the Job using the Job.getStdin, Job.getStdout, and Job.getStderr methods.