csbase.server.services.opendreamsservice.opendreams.v2_0

Class OpenDreamsJob

java.lang.Object

csbase.server.services.opendreamsservice.opendreams.v2_0.OpenDreamsJob

All Implemented Interfaces:

Serializable, tecgraf.openbus.DRMAA.v2_0.JobOperations

public class OpenDreamsJob
extends Object
implements tecgraf.openbus.DRMAA.v2_0.JobOperations, Serializable

Every job in the JobSession is represented by its own instance of the Job interface. It allows one to instruct the DRM system of a job status change, and to query the properties of the job in the DRM system. The job control functions allow modifying the status of a single job in the DRM system, according to the DRMAA 2 state model. If the job is in an inappropriate state for the particular method call, it MUST raise an InvalidStateException.

Author:

Tecgraf/PUC-Rio

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	NO_EXIT_CODE O Job terminou mas não tem um codigo de saída (Acima de 255 não é um exit code válido)

Constructor Summary

Constructors

Constructor and Description
OpenDreamsJob(String sessionName, tecgraf.openbus.opendreams.v2_0.OpenDreamsJobTemplate jt)

Method Summary

Modifier and Type	Method and Description
tecgraf.openbus.DRMAA.v2_0.Job	corbaObjectReference()
void	execute(String userId)
void	flush(String userId) Manipulação dos arquivos e dados de saída do job.
tecgraf.openbus.DRMAA.v2_0.JobInfo	getInfo() This method returns a JobInfo instance for the particular job.
tecgraf.openbus.DRMAA.v2_0.JobState	getState(AnyHolder jobSubState) This method allows the application to get the current status of the job according to the DRMAA state model, together with an implementation specific sub state (see Section 8.1).
void	hold() Triggers a transition from QUEUED to QUEUED_HELD, or from REQUEUED to REQUEUED_HELD state.
String	jobId() This attribute reports the job identifier assigned by the DRM system in text form.
tecgraf.openbus.DRMAA.v2_0.JobTemplate	jobTemplate() This attribute provides a reference to a JobTemplate instance that has equal values to the one that was used for the job submission creating this Job instance.
void	onFinish(String userId, csbase.logic.CommandNotification cmdEvent) Handle required actions after the job enters one of the "Terminated" states.
void	reap()
void	release() Triggers a transition from QUEUED_HELD to QUEUED, or from REQUEUED_HELD to REQUEUED state.
void	resume() Triggers a transition from SUSPENDED to RUNNING state.
String	sessionName() This attribute reports the name of the JobSession that was used to create the job.
void	suspend() Triggers a transition from RUNNING to SUSPENDED state.
void	terminate() Triggers a transition from any of the "Started" states to one of the "Terminated" states.
void	waitStarted(long timeout) Blocks until the job entered one of the "Started" states.
void	waitTerminated(long timeout) Blocks until the job entered one of the "Terminated" states

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NO_EXIT_CODE

public static final int NO_EXIT_CODE

O Job terminou mas não tem um codigo de saída (Acima de 255 não é um exit code válido)

See Also:

Constant Field Values

Constructor Detail

OpenDreamsJob

public OpenDreamsJob(String sessionName,
                     tecgraf.openbus.opendreams.v2_0.OpenDreamsJobTemplate jt)

Parameters:

sessionName -

jt -

Method Detail

jobId

public String jobId()

This attribute reports the job identifier assigned by the DRM system in text form. This method is expected to be used as a fast alternative to the fetching of a complete JobInfo instance.

Specified by:

jobId in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

sessionName

public String sessionName()

This attribute reports the name of the JobSession that was used to create the job.

Specified by:

sessionName in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

jobTemplate

public tecgraf.openbus.DRMAA.v2_0.JobTemplate jobTemplate()

This attribute provides a reference to a JobTemplate instance that has equal values to the one that was used for the job submission creating this Job instance.

Specified by:

jobTemplate in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

corbaObjectReference

public tecgraf.openbus.DRMAA.v2_0.Job corbaObjectReference()
                                                    throws csbase.exception.OperationFailureException,
                                                           ServantNotActive,
                                                           WrongPolicy

Returns:

a stub object that references the actual server's object

Throws:

csbase.exception.OperationFailureException

ServantNotActive

WrongPolicy

execute

public void execute(String userId)
             throws InvalidJobTemplateException

Parameters:

userId - o identificador do usuário que fez a submissão

Throws:

InvalidJobTemplateException - se houver um erro na descrição do job template

suspend

public void suspend()
             throws tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

Triggers a transition from RUNNING to SUSPENDED state.

Specified by:

suspend in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

resume

public void resume()
            throws tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

Triggers a transition from SUSPENDED to RUNNING state.

Specified by:

resume in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

hold

public void hold()
          throws tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

Triggers a transition from QUEUED to QUEUED_HELD, or from REQUEUED to REQUEUED_HELD state.

Specified by:

hold in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

release

public void release()
             throws tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

Triggers a transition from QUEUED_HELD to QUEUED, or from REQUEUED_HELD to REQUEUED state.

Specified by:

release in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

terminate

public void terminate()
               throws tecgraf.openbus.DRMAA.v2_0.DrmCommunicationException,
                      tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException,
                      tecgraf.openbus.DRMAA.v2_0.InternalException

Triggers a transition from any of the "Started" states to one of the "Terminated" states.

Specified by:

terminate in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.DrmCommunicationException

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException

tecgraf.openbus.DRMAA.v2_0.InternalException

reap

public void reap()
          throws tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

Specified by:

reap in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

onFinish

public void onFinish(String userId,
                     csbase.logic.CommandNotification cmdEvent)

Handle required actions after the job enters one of the "Terminated" states.

getState

public tecgraf.openbus.DRMAA.v2_0.JobState getState(AnyHolder jobSubState)

This method allows the application to get the current status of the job according to the DRMAA state model, together with an implementation specific sub state (see Section 8.1). It is intended as a fast alternative to the fetching of a complete JobInfo instance.

Specified by:

getState in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

getInfo

public tecgraf.openbus.DRMAA.v2_0.JobInfo getInfo()

This method returns a JobInfo instance for the particular job.

Specified by:

getInfo in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

waitStarted

public void waitStarted(long timeout)
                 throws tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

Blocks until the job entered one of the "Started" states.

Specified by:

waitStarted in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

waitTerminated

public void waitTerminated(long timeout)
                    throws tecgraf.openbus.DRMAA.v2_0.TimeoutException,
                           tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException,
                           tecgraf.openbus.DRMAA.v2_0.InternalException

Blocks until the job entered one of the "Terminated" states

Specified by:

waitTerminated in interface tecgraf.openbus.DRMAA.v2_0.JobOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.TimeoutException

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException

tecgraf.openbus.DRMAA.v2_0.InternalException

flush

public void flush(String userId)

Manipulação dos arquivos e dados de saída do job.

Parameters:

userId -