csbase.server.services.opendreamsservice.opendreams.v2_0

Class OpenDreamsJobSession

java.lang.Object

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

All Implemented Interfaces:

Serializable, tecgraf.openbus.DRMAA.v2_0.JobSessionOperations

public class OpenDreamsJobSession
extends Object
implements tecgraf.openbus.DRMAA.v2_0.JobSessionOperations, 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(String sessionName, String contact, String userId)

Method Summary

Modifier and Type	Method and Description
String	contact() This method returns the contact value that was used in the #createJobSession.
tecgraf.openbus.DRMAA.v2_0.JobSession	corbaObjectReference()
static List<Field>	getAllFields(List<Field> fields, Class<?> type)
tecgraf.openbus.DRMAA.v2_0.JobArray	getJobArray(String jobArrayId)
tecgraf.openbus.DRMAA.v2_0.Job[]	getJobs(tecgraf.openbus.DRMAA.v2_0.JobInfo filter)
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)
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(String sessionName,
                            String contact,
                            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 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 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 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)

Specified by:

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

getAllFields

public static List<Field> getAllFields(List<Field> fields,
                                       Class<?> type)

getJobArray

public tecgraf.openbus.DRMAA.v2_0.JobArray getJobArray(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

corbaObjectReference

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

Returns:

a stub object that references the actual server's object

Throws:

csbase.exception.OperationFailureException

ServantNotActive

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