csbase.server.services.opendreamsservice.opendreams.v2_0

Class SessionManager

java.lang.Object

org.omg.PortableServer.Servant

tecgraf.openbus.opendreams.v2_0.IOpenDreamsPOA

csbase.server.services.opendreamsservice.opendreams.v2_0.SessionManager

All Implemented Interfaces:

Serializable, InvokeHandler, tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations, tecgraf.openbus.opendreams.v2_0.IOpenDreamsOperations

public class SessionManager
extends tecgraf.openbus.opendreams.v2_0.IOpenDreamsPOA
implements Serializable

Author:

Tecgraf/PUC-Rio

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	UNSET Default String.
static Integer	UNSET_INTEGER Default Integer.
static Long	UNSET_LONG Default Long.

Constructor Summary

Constructors

Constructor and Description
SessionManager() Constrói o objeto que implementa a interface IOpenDreams.

Method Summary

Modifier and Type	Method and Description
static void	checkUser(String userId) Verifica se o usuário é cadastrado no CSBase.
void	closeJobSession(tecgraf.openbus.DRMAA.v2_0.JobSession s)
tecgraf.openbus.DRMAA.v2_0.JobSession	createJobSession(String sessionName, String contact)
void	destroyJobSession(String sessionName)
String	drmaaName() This attribute contains a string identifying the vendor of the DRMAA implementation.
tecgraf.openbus.DRMAA.v2_0.Version	drmaaVersion() This attribute provides the minor / major version number information for the DRMAA implementation.
String	drmsName() A read-only system identifier denoting the DRM system targeted by the implementation, e.g., “LSF” or “GridWay”.
tecgraf.openbus.DRMAA.v2_0.Version	drmsVersion() This attribute provides the DRM-system specific version information.
String[]	getJobSessionNames()
tecgraf.openbus.DRMAA.v2_0.JobSession	openJobSession(String sessionName) The method is used to open a persisted JobSession or ReservationSession instance that has previously been created under the given sessionName.
void	registerEventNotification(tecgraf.openbus.DRMAA.v2_0.DrmaaCallback callback)
boolean	supports(tecgraf.openbus.DRMAA.v2_0.DrmaaCapability capability) This method allows to test if the DRMAA implementation supports a feature specified as optional.

Methods inherited from class tecgraf.openbus.opendreams.v2_0.IOpenDreamsPOA

_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

Field Detail

UNSET

public static final String UNSET

Default String.

See Also:

Constant Field Values

UNSET_INTEGER

public static final Integer UNSET_INTEGER

Default Integer.

UNSET_LONG

public static final Long UNSET_LONG

Default Long.

Constructor Detail

SessionManager

public SessionManager()

Constrói o objeto que implementa a interface IOpenDreams.

Method Detail

drmsName

public String drmsName()

A read-only system identifier denoting the DRM system targeted by the implementation, e.g., “LSF” or “GridWay”. Implementations SHOULD NOT make versioning information of the particular DRM system a part of this attribute value. The value is only intended as informative output for application users.

Specified by:

drmsName in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

drmsVersion

public tecgraf.openbus.DRMAA.v2_0.Version drmsVersion()

This attribute provides the DRM-system specific version information. The value is only intended as informative output for application users

Specified by:

drmsVersion in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

drmaaName

public String drmaaName()

This attribute contains a string identifying the vendor of the DRMAA implementation. The value is only intended as informative output for application users.

Specified by:

drmaaName in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

drmaaVersion

public tecgraf.openbus.DRMAA.v2_0.Version drmaaVersion()

This attribute provides the minor / major version number information for the DRMAA implementation. The major version number MUST be the constant value “2”, the minor version number SHOULD be used by the DRMAA implementation for expressing its own versioning information.

Specified by:

drmaaVersion in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

supports

public boolean supports(tecgraf.openbus.DRMAA.v2_0.DrmaaCapability capability)

This method allows to test if the DRMAA implementation supports a feature specified as optional. The allowed input values are specified in the DrmaaCapability enumeration.

Specified by:

supports in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

createJobSession

public tecgraf.openbus.DRMAA.v2_0.JobSession createJobSession(String sessionName,
                                                              String contact)
                                                       throws tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException,
                                                              tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException,
                                                              tecgraf.openbus.DRMAA.v2_0.InternalException

Specified by:

createJobSession in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

Parameters:

sessionName - Denotes a unique name to be used for the new session. If a session with such a name already exists, the method MUST throw an InvalidArgumentException. In all other cases, including if the provided name has the value UNSET, a new session MUST be created with a unique name generated by the implementation

contact - in some of the interface methods SHALL allow the application to specify which DRM system instance to use. A contact string represents a specific installation of a specific DRM system, e.g., a Condor central manager machine at a given IP address, or a Grid Engine ‘root’ and ‘cell’. Contact strings are always implementation-specific and therefore opaque to the application. If contact has the value UNSET, a default DRM system SHOULD be contacted. The manual configuration or automated detection of a default contact string is implementation-specific.

Throws:

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException

tecgraf.openbus.DRMAA.v2_0.InternalException

tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException

openJobSession

public tecgraf.openbus.DRMAA.v2_0.JobSession openJobSession(String sessionName)
                                                     throws tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException,
                                                            tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException,
                                                            tecgraf.openbus.DRMAA.v2_0.InternalException

The method is used to open a persisted JobSession or ReservationSession instance that has previously been created under the given sessionName. The implementation MUST support the case that the session have been created by the same application or by a different application running on the same machine.

Specified by:

openJobSession in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

Throws:

tecgraf.openbus.DRMAA.v2_0.InvalidArgumentException

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException

tecgraf.openbus.DRMAA.v2_0.InternalException

closeJobSession

public void closeJobSession(tecgraf.openbus.DRMAA.v2_0.JobSession s)

Specified by:

closeJobSession in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

destroyJobSession

public void destroyJobSession(String sessionName)

Specified by:

destroyJobSession in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

getJobSessionNames

public String[] getJobSessionNames()

Specified by:

getJobSessionNames in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

registerEventNotification

public void registerEventNotification(tecgraf.openbus.DRMAA.v2_0.DrmaaCallback callback)

Specified by:

registerEventNotification in interface tecgraf.openbus.DRMAA.v2_0.SessionManagerOperations

checkUser

public static void checkUser(String userId)
                      throws tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException

Verifica se o usuário é cadastrado no CSBase.

Parameters:

userId - identificador do usuário

Throws:

tecgraf.openbus.DRMAA.v2_0.DeniedByDrmsException - caso não exista um usuário com o identificador