csbase.server.services.opendreamsservice.opendreams.v1_7

Class OpenDreamsSession

java.lang.Object

org.omg.PortableServer.Servant

tecgraf.openbus.DRMAA.v1_7.SessionPOA

csbase.server.services.opendreamsservice.opendreams.v1_7.Session

csbase.server.services.opendreamsservice.opendreams.v1_7.OpenDreamsSession

All Implemented Interfaces:

InvokeHandler, tecgraf.openbus.DRMAA.v1_7.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_7.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_7.JobInfo	_wait(String jobName, long timeout)
String	contact()
void	control(String jobName, tecgraf.openbus.DRMAA.v1_7.JobControlAction operation)
tecgraf.openbus.DRMAA.v1_7.JobTemplate	createJobTemplate()
void	deleteJobTemplate(tecgraf.openbus.DRMAA.v1_7.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 CSBase como sistema DRMS.
tecgraf.openbus.DRMAA.v1_7.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[]	runBulkJobs(tecgraf.openbus.DRMAA.v1_7.JobTemplate jt, int beginIndex, int endIndex, int step)
String	runJob(tecgraf.openbus.DRMAA.v1_7.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.
void	synchronize(String[] jobList, long timeout, boolean dispose)
void	terminateJob(String jobName) Termina um job submetido para execução.
tecgraf.openbus.DRMAA.v1_7.Version	version()

Methods inherited from class tecgraf.openbus.DRMAA.v1_7.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_7.AlreadyActiveSessionException,
                 tecgraf.openbus.DRMAA.v1_7.InternalException,
                 tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                 tecgraf.openbus.DRMAA.v1_7.InvalidContactStringException

Usa o sistema CSBase como sistema DRMS. O valor do parâmetro contactString, quando não for null ou vazio, deve ser igual ao retornado por contact().

Specified by:

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

Specified by:

init in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.AlreadyActiveSessionException

tecgraf.openbus.DRMAA.v1_7.InternalException

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.InvalidContactStringException

exit

public void exit()
          throws tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                 tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException,
                 tecgraf.openbus.DRMAA.v1_7.InternalException

Specified by:

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

Specified by:

exit in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_7.InternalException

createJobTemplate

public tecgraf.openbus.DRMAA.v1_7.JobTemplate createJobTemplate()
                                                         throws tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                                                                tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException,
                                                                tecgraf.openbus.DRMAA.v1_7.InternalException

Specified by:

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

Specified by:

createJobTemplate in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_7.InternalException

deleteJobTemplate

public void deleteJobTemplate(tecgraf.openbus.DRMAA.v1_7.JobTemplate jt)
                       throws tecgraf.openbus.DRMAA.v1_7.InvalidJobTemplateException,
                              tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                              tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException,
                              tecgraf.openbus.DRMAA.v1_7.InternalException

Specified by:

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

Specified by:

deleteJobTemplate in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.InvalidJobTemplateException

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_7.InternalException

runBulkJobs

public String[] runBulkJobs(tecgraf.openbus.DRMAA.v1_7.JobTemplate jt,
                            int beginIndex,
                            int endIndex,
                            int step)
                     throws tecgraf.openbus.DRMAA.v1_7.InvalidArgumentException,
                            tecgraf.openbus.DRMAA.v1_7.InternalException,
                            tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                            tecgraf.openbus.DRMAA.v1_7.DeniedByDrmException,
                            tecgraf.openbus.DRMAA.v1_7.InvalidJobTemplateException,
                            tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

Specified by:

runBulkJobs in interface tecgraf.openbus.DRMAA.v1_7.SessionOperations

Specified by:

runBulkJobs in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.InvalidArgumentException

tecgraf.openbus.DRMAA.v1_7.InternalException

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.DeniedByDrmException

tecgraf.openbus.DRMAA.v1_7.InvalidJobTemplateException

tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

runJob

public String runJob(tecgraf.openbus.DRMAA.v1_7.JobTemplate jt)
              throws tecgraf.openbus.DRMAA.v1_7.InternalException,
                     tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                     tecgraf.openbus.DRMAA.v1_7.DeniedByDrmException,
                     tecgraf.openbus.DRMAA.v1_7.InvalidJobTemplateException,
                     tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

Specified by:

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

Specified by:

runJob in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.InternalException

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.DeniedByDrmException

tecgraf.openbus.DRMAA.v1_7.InvalidJobTemplateException

tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

synchronize

public void synchronize(String[] jobList,
                        long timeout,
                        boolean dispose)
                 throws tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                        tecgraf.openbus.DRMAA.v1_7.ExitTimeoutException,
                        tecgraf.openbus.DRMAA.v1_7.InternalException,
                        tecgraf.openbus.DRMAA.v1_7.InvalidJobException

Specified by:

synchronize in interface tecgraf.openbus.DRMAA.v1_7.SessionOperations

Specified by:

synchronize in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.ExitTimeoutException

tecgraf.openbus.DRMAA.v1_7.InternalException

tecgraf.openbus.DRMAA.v1_7.InvalidJobException

_wait

public tecgraf.openbus.DRMAA.v1_7.JobInfo _wait(String jobName,
                                                long timeout)
                                         throws tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                                                tecgraf.openbus.DRMAA.v1_7.ExitTimeoutException,
                                                tecgraf.openbus.DRMAA.v1_7.InternalException,
                                                tecgraf.openbus.DRMAA.v1_7.InvalidJobException

Specified by:

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

Specified by:

_wait in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.ExitTimeoutException

tecgraf.openbus.DRMAA.v1_7.InternalException

tecgraf.openbus.DRMAA.v1_7.InvalidJobException

jobStatus

public tecgraf.openbus.DRMAA.v1_7.JobState jobStatus(String jobName)
                                              throws tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                                                     tecgraf.openbus.DRMAA.v1_7.InternalException,
                                                     tecgraf.openbus.DRMAA.v1_7.InvalidJobException

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_7.SessionOperations

Specified by:

jobStatus in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.InternalException

tecgraf.openbus.DRMAA.v1_7.InvalidJobException

contact

public String contact()

Specified by:

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

Specified by:

contact in class Session

control

public void control(String jobName,
                    tecgraf.openbus.DRMAA.v1_7.JobControlAction operation)
             throws tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException,
                    tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                    tecgraf.openbus.DRMAA.v1_7.InvalidArgumentException,
                    tecgraf.openbus.DRMAA.v1_7.InvalidJobException,
                    tecgraf.openbus.DRMAA.v1_7.DrmCommunicationException,
                    tecgraf.openbus.DRMAA.v1_7.InternalException

Specified by:

control in interface tecgraf.openbus.DRMAA.v1_7.SessionOperations

Specified by:

control in class Session

Throws:

tecgraf.openbus.DRMAA.v1_7.NoActiveSessionException

tecgraf.openbus.DRMAA.v1_7.AuthorizationException

tecgraf.openbus.DRMAA.v1_7.InvalidArgumentException

tecgraf.openbus.DRMAA.v1_7.InvalidJobException

tecgraf.openbus.DRMAA.v1_7.DrmCommunicationException

tecgraf.openbus.DRMAA.v1_7.InternalException

version

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

Specified by:

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

Specified by:

version in class Session

drmaaImplementation

public String drmaaImplementation()

Specified by:

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

Specified by:

drmaaImplementation in class Session

drmsInfo

public String drmsInfo()

Specified by:

drmsInfo in interface tecgraf.openbus.DRMAA.v1_7.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.

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.

getProject

public csbase.logic.CommonClientProject getProject()

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

Returns:

o projeto associado a essa sessão.

terminateJob

public void terminateJob(String jobName)
                  throws tecgraf.openbus.DRMAA.v1_7.AuthorizationException,
                         tecgraf.openbus.DRMAA.v1_7.InvalidJobException,
                         tecgraf.openbus.DRMAA.v1_7.DrmCommunicationException

Termina um job submetido para execução.

Parameters:

jobName - nome do job

Throws:

tecgraf.openbus.DRMAA.v1_7.AuthorizationException - se o usuário não tem permissão para cancelar o job

tecgraf.openbus.DRMAA.v1_7.InvalidJobException - se o identificador não foi encontrado

tecgraf.openbus.DRMAA.v1_7.DrmCommunicationException - se o SGA não está disponível