csbase.server.services.opendreamsservice.opendreams.v2_0

Class OpenDreamsJobSession

java.lang.Object

csbase.server.services.opendreamsservice.opendreams.v2_0.OpenDreamsJobSession

All Implemented Interfaces:

java.io.Serializable, tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

public class OpenDreamsJobSession
extends java.lang.Object
implements tecgraf.openbus.DRMAA.v2_0.JobSessionOperations, java.io.Serializable

Author:

Tecgraf/PUC-Rio

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	TIMEOUT_NO_WAIT Constante para espera sem timeout.
static long	TIMEOUT_WAIT_FOREVER Constante para timeout infinito.

Constructor Summary

Constructors

Constructor and Description
OpenDreamsJobSession(java.lang.String sessionName, java.lang.String contact, java.lang.String userId)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	contact() This method returns the contact value that was used in the #createJobSession.
tecgraf.openbus.DRMAA.v2_0.JobSession	createCorbaObjReference()
tecgraf.openbus.DRMAA.v2_0.JobArray	getJobArray(java.lang.String jobArrayId)
tecgraf.openbus.DRMAA.v2_0.Job[]	getJobs(tecgraf.openbus.DRMAA.v2_0.JobInfo filter) //TODO: how to filter jobs? only jobId? This method returns the set of jobs that belong to the job session.
java.lang.String[]	jobCategories() UNSUPPORTED This method provides the list of valid job category names which can be used for the jobCategory attribute in a JobTemplate instance
void	onResume() Método utilizado para reiniciar serviços da sessão, caso seja necessário.
tecgraf.openbus.DRMAA.v2_0.JobArray	runBulkJobs(tecgraf.openbus.DRMAA.v2_0.JobTemplate jobTemplate, int beginIndex, int endIndex, int step, int maxParallel)
tecgraf.openbus.DRMAA.v2_0.Job	runJob(tecgraf.openbus.DRMAA.v2_0.JobTemplate jobTemplate)
java.lang.String	sessionName() This method returns the session name, a unique session identifier passed through #createJobSession.
tecgraf.openbus.DRMAA.v2_0.Job	waitAnyStarted(tecgraf.openbus.DRMAA.v2_0.Job[] jobs, long timeout) The waitAnyStarted method blocks until any of the jobs referenced in the jobs parameter entered one of the "Started" states.
tecgraf.openbus.DRMAA.v2_0.Job	waitAnyTerminated(tecgraf.openbus.DRMAA.v2_0.Job[] jobs, long timeout) The waitAnyTerminated method blocks until any of the jobs referenced in the jobs parameter 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

TIMEOUT_WAIT_FOREVER

public static long TIMEOUT_WAIT_FOREVER

Constante para timeout infinito.

TIMEOUT_NO_WAIT

public static long TIMEOUT_NO_WAIT

Constante para espera sem timeout.

Constructor Detail

OpenDreamsJobSession

public OpenDreamsJobSession(java.lang.String sessionName,
                    java.lang.String contact,
                    java.lang.String userId)

Parameters:

sessionName -

contact -

userId -

Method Detail

onResume

public void onResume()

Método utilizado para reiniciar serviços da sessão, caso seja necessário. Chamado em #openJobSession(String).

contact

public java.lang.String contact()

This method returns the contact value that was used in the #createJobSession. This attribute is read-only.

Specified by:

contact in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

sessionName

public java.lang.String sessionName()

This method returns the session name, a unique session identifier passed through #createJobSession. This attribute is read-only.

Specified by:

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

jobCategories

public java.lang.String[] jobCategories()

UNSUPPORTED This method provides the list of valid job category names which can be used for the jobCategory attribute in a JobTemplate instance

Specified by:

jobCategories in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

getJobs

public tecgraf.openbus.DRMAA.v2_0.Job[] getJobs(tecgraf.openbus.DRMAA.v2_0.JobInfo filter)

//TODO: how to filter jobs? only jobId? This method returns the set of jobs that belong to the job session. The filter parameter allows to choose a subset of the session jobs as return value. The semantics of the filter argument are explained in Section 5.5. If no job matches or the session has no jobs attached, the method MUST return an empty set. If filter is UNSET, all session jobs MUST be returned. Time-dependent effects of this method, such as jobs no longer matching to filter criteria on evaluation time, are implementation-specific. The purpose of the filter parameter is to keep scalability with a large number of jobs per session. Applications therefore must consider the possibly changed state of jobs during their evaluation of the method result.

Specified by:

getJobs in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

getJobArray

public tecgraf.openbus.DRMAA.v2_0.JobArray getJobArray(java.lang.String jobArrayId)
                                                throws tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException,
                                                       tecgraf.openbus.DRMAA.v2_0.InternalException

Specified by:

getJobArray in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException

tecgraf.openbus.DRMAA.v2_0.InternalException

runJob

public tecgraf.openbus.DRMAA.v2_0.Job runJob(tecgraf.openbus.DRMAA.v2_0.JobTemplate jobTemplate)
                                      throws tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException,
                                             tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException,
                                             tecgraf.openbus.DRMAA.v2_0.InternalException

Specified by:

runJob in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException

tecgraf.openbus.DRMAA.v2_0.InternalException

tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException

createCorbaObjReference

public tecgraf.openbus.DRMAA.v2_0.JobSession createCorbaObjReference()
                                                              throws csbase.exception.OperationFailureException,
                                                                     org.omg.PortableServer.POAPackage.ServantNotActive,
                                                                     org.omg.PortableServer.POAPackage.WrongPolicy

Returns:

a stub object that references the actual server's object

Throws:

csbase.exception.OperationFailureException

org.omg.PortableServer.POAPackage.ServantNotActive

org.omg.PortableServer.POAPackage.WrongPolicy

runBulkJobs

public tecgraf.openbus.DRMAA.v2_0.JobArray runBulkJobs(tecgraf.openbus.DRMAA.v2_0.JobTemplate jobTemplate,
                                              int beginIndex,
                                              int endIndex,
                                              int step,
                                              int maxParallel)
                                                throws tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException,
                                                       tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException,
                                                       tecgraf.openbus.DRMAA.v2_0.InternalException

Specified by:

runBulkJobs in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException

tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException

tecgraf.openbus.DRMAA.v2_0.InternalException

waitAnyStarted

public tecgraf.openbus.DRMAA.v2_0.Job waitAnyStarted(tecgraf.openbus.DRMAA.v2_0.Job[] jobs,
                                            long timeout)
                                              throws tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

The waitAnyStarted method blocks until any of the jobs referenced in the jobs parameter entered one of the "Started" states.

Specified by:

waitAnyStarted in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.UnsupportedOperationException

waitAnyTerminated

public tecgraf.openbus.DRMAA.v2_0.Job waitAnyTerminated(tecgraf.openbus.DRMAA.v2_0.Job[] jobs,
                                               long timeout)
                                                 throws tecgraf.openbus.DRMAA.v2_0.TimeoutException,
                                                        tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException,
                                                        tecgraf.openbus.DRMAA.v2_0.InternalException

The waitAnyTerminated method blocks until any of the jobs referenced in the jobs parameter entered one of the "Terminated" states. The timeout argument specifies the desired waiting time for the state change. The constant value INFINITE_TIME MUST be supported to get an indefinite waiting time. The constant value ZERO_TIME MUST be supported to express that the method call SHALL return immediately. A number of seconds can be specified to indicate the maximum waiting time . If the method call returns because of timeout, an TimeoutException SHALL be raised. An application waiting for some condition to happen in all jobs of a set is expected to perform looped calls of these waiting functions.

Specified by:

waitAnyTerminated in interface tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.InternalException

tecgraf.openbus.DRMAA.v2_0.TimeoutException

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException