alma.acs.commandcenter.meta

Interface IMaciSupervisor

All Known Implementing Classes:

GuiMaciSupervisor, MaciSupervisor

public interface IMaciSupervisor

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IMaciSupervisor.CannotRetrieveManagerException Can happen when trying to log in to the manager.
static class	IMaciSupervisor.CorbaNoPermissionException Can happen when trying to shutdown the manager.
static class	IMaciSupervisor.CorbaNotExistException Can happen when trying to log in to the manager.
static class	IMaciSupervisor.CorbaTransientException Can happen at every access to the manager.
static class	IMaciSupervisor.CorbaUnknownException Can happen when releasing a component that wasn't activated before.
static class	IMaciSupervisor.MaciSupervisorException Base class of the exceptions we're creating ourselves.
static class	IMaciSupervisor.NotConnectedToManagerException Can happen at every access to the manager.
static class	IMaciSupervisor.UnknownErrorException

Field Summary

Fields

Modifier and Type	Field and Description
static short	MSG_ERROR
static short	MSG_INFORMATION

Method Summary

Modifier and Type	Method and Description
void	dismissManager() msc (2004-11-09): This was requested, suggested, and agreed upon as a workaround for the situation where a manager has gone down (and the application using this macisupervisor knows that the manager is down, e.g.
MaciInfo	getMaciInfo() Returns a maciInfo instance as retrieved from the manager.
java.lang.String	getManagerLocation() Some people are interested in the weirdest things..
boolean	isConnected() Whether this is connected to a manager
int	myMaciHandle() Returns the handle given by the manager.
void	start() Start must be called after construction, before usage.
void	stop() Stop this instance.

Field Detail

MSG_INFORMATION

static final short MSG_INFORMATION

MSG_ERROR

static final short MSG_ERROR

Method Detail

start

void start()
    throws IMaciSupervisor.CannotRetrieveManagerException,
           NoPermissionEx,
           IMaciSupervisor.CorbaTransientException,
           IMaciSupervisor.CorbaNotExistException,
           IMaciSupervisor.UnknownErrorException

Start must be called after construction, before usage.

Throws:

IMaciSupervisor.CannotRetrieveManagerException

NoPermissionEx

IMaciSupervisor.CorbaTransientException

IMaciSupervisor.CorbaNotExistException

IMaciSupervisor.UnknownErrorException

stop

void stop()

Stop this instance. It's possible to start again later on.

dismissManager

void dismissManager()

msc (2004-11-09): This was requested, suggested, and agreed upon as a workaround for the situation where a manager has gone down (and the application using this macisupervisor knows that the manager is down, e.g. because it made it go down) while this macisupervisor does not yet know that the manager is down. It will only realize that the next time it tries to access it. Doing so will provoke some no_permission error messages in the manager log. To enable the application to avoid these error messages this API method was added.

isConnected

boolean isConnected()

Whether this is connected to a manager

getManagerLocation

java.lang.String getManagerLocation()

Some people are interested in the weirdest things..

myMaciHandle

int myMaciHandle()
          throws IMaciSupervisor.NotConnectedToManagerException

Returns the handle given by the manager.

Returns:

the handle given by the manager.

Throws:

IMaciSupervisor.NotConnectedToManagerException - if no handle available

getMaciInfo

MaciInfo getMaciInfo()
              throws NoPermissionEx,
                     IMaciSupervisor.NotConnectedToManagerException,
                     IMaciSupervisor.CorbaTransientException,
                     IMaciSupervisor.CorbaNotExistException,
                     IMaciSupervisor.UnknownErrorException

Returns a maciInfo instance as retrieved from the manager.

Returns:

maciInfo

Throws:

IMaciSupervisor.NotConnectedToManagerException

NoPermissionEx

IMaciSupervisor.UnknownErrorException

IMaciSupervisor.CorbaNotExistException

IMaciSupervisor.CorbaTransientException