org.globus.gram

Class GramJob

java.lang.Object

org.globus.gram.GramJob

All Implemented Interfaces:

GRAMConstants

Direct Known Subclasses:

GramJobRun

public class GramJob
extends Object
implements GRAMConstants

This class represents a simple gram job. It allows for submitting a job to a gatekeeper, canceling it, sending a signal command and registering and unregistering from callback.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	error
protected int	exitCode
protected int	status

Fields inherited from interface org.globus.gram.internal.GRAMConstants

SIGNAL_CANCEL, SIGNAL_COMMIT_END, SIGNAL_COMMIT_EXTEND, SIGNAL_COMMIT_REQUEST, SIGNAL_PRIORITY, SIGNAL_RESUME, SIGNAL_STDIO_SIZE, SIGNAL_STDIO_UPDATE, SIGNAL_STOP_MANAGER, SIGNAL_SUSPEND, STATUS_ACTIVE, STATUS_ALL, STATUS_DONE, STATUS_FAILED, STATUS_PENDING, STATUS_STAGE_IN, STATUS_STAGE_OUT, STATUS_SUSPENDED, STATUS_UNSUBMITTED

Constructor Summary

Constructors

Constructor and Description
GramJob(GSSCredential cred, String rsl) Creates a gram job with specified rsl and user credentials.
GramJob(String rsl) Creates a gram job with specified rsl with default user credentials.

Method Summary

Modifier and Type	Method and Description
void	addListener(GramJobListener listener) Add a listener to the GramJob.
void	bind() Registers a callback listener for this job.
void	cancel() Cancels a job.
GSSCredential	getCredentials() Gets the credentials of this job.
int	getError() Gets the error of the job.
int	getExitCode() Allows querying the job exit code.
GlobusURL	getID() Gets the job handle of this job.
String	getIDAsString() Gets the job handle of this job and returns it as a string representaion.
String	getRSL() Gets the rsl of this job.
int	getStatus() Gets the current status of this job.
String	getStatusAsString() Get the status of the GramJob.
static String	getStatusAsString(int status) Convert the status of a GramJob from an integer to a string.
boolean	isExitCodeValid() Can be used to determine whether the job exit code returned by getExitCode() is valid.
void	removeListener(GramJobListener listener) Remove a listener from the GramJob.
void	renew(GSSCredential newCred) Requests that the job's delegated credentials be renewed/refreshed.
void	renew(GSSCredential newCred, boolean limitedDelegation) Requests that the job's delegated credentials be renewed/refreshed.
void	request(String contact) Submits a job to the specified gatekeeper as an interactive job.
void	request(String contact, boolean batch) Submits a job to the specified gatekeeper either as an interactive or batch job.
void	request(String contact, boolean batch, boolean limitedDelegation) Submits a job to the specified gatekeeper either as an interactive or batch job.
void	setCredentials(GSSCredential credential) Sets credentials of the job
protected void	setError(int code) Sets the error code of the job.
protected void	setExitCode(int exitCode) Sets the job exit code.
void	setID(String jobUrl) Sets the job handle.
protected void	setStatus(int status) Sets the status of the job.
int	signal(int signal) Sends a signal command to the job.
int