csbase.server.services.opendreamsservice.opendreams.v1_06

Class OpenDreamsSession

java.lang.Object

org.omg.PortableServer.Servant

tecgraf.openbus.DRMAA.v1_06.SessionPOA

csbase.server.services.opendreamsservice.opendreams.v1_06.Session

csbase.server.services.opendreamsservice.opendreams.v1_06.OpenDreamsSession

All Implemented Interfaces:

InvokeHandler, tecgraf.openbus.DRMAA.v1_06.SessionOperations

public class OpenDreamsSession
extends Session

Implementa uma sessão no OpenDreams. Guarda o projeto ao qual essa sessão está associada.

Author:

Tecgraf PUC-Rio

Field Summary

Fields inherited from interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

JOB_IDS_SESSION_ALL, JOB_IDS_SESSION_ANY, TIMEOUT_NO_WAIT, TIMEOUT_WAIT_FOREVER

Constructor Summary

Constructors

Constructor and Description
OpenDreamsSession() Construtor.

Method Summary

Modifier and Type	Method and Description
tecgraf.openbus.DRMAA.v1_06.JobInfo	_wait(String jobName, long timeout)
String	contact()
tecgraf.openbus.DRMAA.v1_06.JobTemplate	createJobTemplate()
void	deleteJobTemplate(tecgraf.openbus.DRMAA.v1_06.JobTemplate jt)
String	drmaaImplementation()
String	drmsInfo()
void	exit()
csbase.logic.CommonClientProject	getProject() Obtém o projeto associado a essa sessão.
void	init(String contactString) Usa o sistema CSGrid como sistema DRMS.
tecgraf.openbus.DRMAA.v1_06.JobState	jobStatus(String jobName) O OpenDreams verifica se o job já finalizou usando um cache próprio que mantém as informações sobre jobs que finalizaram.
String	runJob(tecgraf.openbus.DRMAA.v1_06.JobTemplate jt)
void	setProject(csbase.logic.CommonClientProject project) Altera o projeto associado a essa sessão.
void	setUser(String userId) Altera o usuário associado a essa sessão.
tecgraf.openbus.DRMAA.v1_06.Version	version()

Methods inherited from class csbase.server.services.opendreamsservice.opendreams.v1_06.Session

control, runBulkJobs, synchronize

Methods inherited from class tecgraf.openbus.DRMAA.v1_06.SessionPOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

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

Constructor Detail

OpenDreamsSession

public OpenDreamsSession()

Construtor.

Method Detail

init

public void init(String contactString)
          throws tecgraf.openbus.DRMAA.v1_06.DefaultContactStringException,
                 tecgraf.openbus.DRMAA.v1_06.NoDefaultContactStringSelectedException,
                 tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException,
                 tecgraf.openbus.DRMAA.v1_06.AlreadyActiveSessionException,
                 tecgraf.openbus.DRMAA.v1_06.InternalException,
                 tecgraf.openbus.DRMAA.v1_06.DrmsInitException,
                 tecgraf.openbus.DRMAA.v1_06.AuthorizationException,
                 tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException,
                 tecgraf.openbus.DRMAA.v1_06.InvalidContactStringException,
                 tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

Usa o sistema CSGrid como sistema DRMS. O valor do parâmetro contactString, quando não for null ou vazio, deve ser csgrid.

Specified by:

init in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

init in class Session

Throws:

tecgraf.openbus.DRMAA.v1_06.DefaultContactStringException

tecgraf.openbus.DRMAA.v1_06.NoDefaultContactStringSelectedException

tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException

tecgraf.openbus.DRMAA.v1_06.AlreadyActiveSessionException

tecgraf.openbus.DRMAA.v1_06.InternalException

tecgraf.openbus.DRMAA.v1_06.DrmsInitException

tecgraf.openbus.DRMAA.v1_06.AuthorizationException

tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

tecgraf.openbus.DRMAA.v1_06.InvalidContactStringException

tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

exit

public void exit()
          throws tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException,
                 tecgraf.openbus.DRMAA.v1_06.DrmsExitException,
                 tecgraf.openbus.DRMAA.v1_06.AuthorizationException,
                 tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException,
                 tecgraf.openbus.DRMAA.v1_06.InternalException,
                 tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

Specified by:

exit in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

exit in class Session

Throws:

tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

tecgraf.openbus.DRMAA.v1_06.DrmsExitException

tecgraf.openbus.DRMAA.v1_06.AuthorizationException

tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_06.InternalException

tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

createJobTemplate

public tecgraf.openbus.DRMAA.v1_06.JobTemplate createJobTemplate()
                                                          throws tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException,
                                                                 tecgraf.openbus.DRMAA.v1_06.AuthorizationException,
                                                                 tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException,
                                                                 tecgraf.openbus.DRMAA.v1_06.InternalException,
                                                                 tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

Specified by:

createJobTemplate in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

createJobTemplate in class Session

Throws:

tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

tecgraf.openbus.DRMAA.v1_06.AuthorizationException

tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_06.InternalException

tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

deleteJobTemplate

public void deleteJobTemplate(tecgraf.openbus.DRMAA.v1_06.JobTemplate jt)
                       throws tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException,
                              tecgraf.openbus.DRMAA.v1_06.InvalidJobTemplateException,
                              tecgraf.openbus.DRMAA.v1_06.AuthorizationException,
                              tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException,
                              tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException,
                              tecgraf.openbus.DRMAA.v1_06.InternalException,
                              tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

Specified by:

deleteJobTemplate in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

deleteJobTemplate in class Session

Throws:

tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

tecgraf.openbus.DRMAA.v1_06.InvalidJobTemplateException

tecgraf.openbus.DRMAA.v1_06.AuthorizationException

tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException

tecgraf.openbus.DRMAA.v1_06.InternalException

tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

runJob

public String runJob(tecgraf.openbus.DRMAA.v1_06.JobTemplate jt)
              throws tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException,
                     tecgraf.openbus.DRMAA.v1_06.InternalException,
                     tecgraf.openbus.DRMAA.v1_06.AuthorizationException,
                     tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException,
                     tecgraf.openbus.DRMAA.v1_06.DeniedByDrmException,
                     tecgraf.openbus.DRMAA.v1_06.InvalidJobTemplateException,
                     tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException,
                     tecgraf.openbus.DRMAA.v1_06.TryLaterException,
                     tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

Specified by:

runJob in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

runJob in class Session

Throws:

tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException

tecgraf.openbus.DRMAA.v1_06.InternalException

tecgraf.openbus.DRMAA.v1_06.AuthorizationException

tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

tecgraf.openbus.DRMAA.v1_06.DeniedByDrmException

tecgraf.openbus.DRMAA.v1_06.InvalidJobTemplateException

tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_06.TryLaterException

tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

_wait

public tecgraf.openbus.DRMAA.v1_06.JobInfo _wait(String jobName,
                                                 long timeout)
                                          throws tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException,
                                                 tecgraf.openbus.DRMAA.v1_06.AuthorizationException,
                                                 tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException,
                                                 tecgraf.openbus.DRMAA.v1_06.ExitTimeoutException,
                                                 tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException,
                                                 tecgraf.openbus.DRMAA.v1_06.InternalException,
                                                 tecgraf.openbus.DRMAA.v1_06.InvalidJobException,
                                                 tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

Specified by:

_wait in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

_wait in class Session

Throws:

tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

tecgraf.openbus.DRMAA.v1_06.AuthorizationException

tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_06.ExitTimeoutException

tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException

tecgraf.openbus.DRMAA.v1_06.InternalException

tecgraf.openbus.DRMAA.v1_06.InvalidJobException

tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

jobStatus

public tecgraf.openbus.DRMAA.v1_06.JobState jobStatus(String jobName)
                                               throws tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException,
                                                      tecgraf.openbus.DRMAA.v1_06.AuthorizationException,
                                                      tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException,
                                                      tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException,
                                                      tecgraf.openbus.DRMAA.v1_06.InternalException,
                                                      tecgraf.openbus.DRMAA.v1_06.InvalidJobException,
                                                      tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

O OpenDreams verifica se o job já finalizou usando um cache próprio que mantém as informações sobre jobs que finalizaram. Se não encontrar a informação nesse cache, pede ao serviço CommandPersistenceService que possui persistido em arquivo as informações sobre todos os jobs submetidos. É importante observar que nem sempre o estado de retorno DONE (finalizado normalmente) significa que o comando terminou com código de retorno igual a zero. Se o configurador do algoritmo não tiver definido a opção que captura a saída do comando, o estado retornado pode ser DONE também. Se o configurador tiver definido a opção que captura a saída do comando e se o comando terminar com um valor diferente de zero, o estado é retornado como FAILED. Os seguintes estados podem ser retornados:

• JobState.QUEUED_ACTIVE: se o comando estiver na fila. Corresponde ao estado SCHEDULED do CommandStatus
• JobState.RUNNING: se o comando já tiver sido removido da fila para ser executado. Corresponde aos seguintes estados do CommandStatus: INIT, UPLOADING, EXECUTING e DOWNLOADING.
• JobState.DONE: se o comando tiver finalizado e o código de saída do job não tiver sido capturado ou se o código de saída do job tiver sido capturado com valor zero. Corresponde ao estado FINISHED do CommandStatus e as seguintes condições de término do job, no CommandFinalizationType: UNKNOWN, END, SUCCESS.
• JobState.FAILED: se o comando tiver finalizado e o código de saída do job tiver sido capturado com valor diferente de zero ou se houve falha na inicialização do comando ou se ele foi cancelado ou se houve falha na obtenção do código de saída. Corresponde ao estado FINISHED do CommandStatus e as seguintes condições de término do job, no CommandFinalizationType: EXECUTION_ERROR, FAILED, KILLED e NO_EXIT_CODE
• JobState.UNDETERMINED: em qualquer condição que não se enquadra nas descritas acima.

Specified by:

jobStatus in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

jobStatus in class Session

Throws:

tecgraf.openbus.DRMAA.v1_06.OutOfMemoryException

tecgraf.openbus.DRMAA.v1_06.AuthorizationException

tecgraf.openbus.DRMAA.v1_06.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_06.InvalidArgumentException

tecgraf.openbus.DRMAA.v1_06.InternalException

tecgraf.openbus.DRMAA.v1_06.InvalidJobException

tecgraf.openbus.DRMAA.v1_06.DrmCommunicationException

contact

public String contact()

Specified by:

contact in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

contact in class Session

version

public tecgraf.openbus.DRMAA.v1_06.Version version()

Specified by:

version in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

version in class Session

drmaaImplementation

public String drmaaImplementation()

Specified by:

drmaaImplementation in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

drmaaImplementation in class Session

drmsInfo

public String drmsInfo()

Specified by:

drmsInfo in interface tecgraf.openbus.DRMAA.v1_06.SessionOperations

Specified by:

drmsInfo in class Session

setProject

public void setProject(csbase.logic.CommonClientProject project)

Altera o projeto associado a essa sessão. O projeto já deve ter sido aberto.

Parameters:

project - o projeto associado a essa sessão.

getProject

public csbase.logic.CommonClientProject getProject()

Obtém o projeto associado a essa sessão.

Returns:

o projeto associado a essa sessão.

setUser

public void setUser(String userId)

Altera o usuário associado a essa sessão.

Parameters:

userId - o identificador do usuário associado a essa sessão.