com.ibm.able.platform
Interface RmiAblePlatformService

All Superinterfaces:

java.rmi.Remote, RmiAblePlatformServiceEventGenerator

All Known Subinterfaces:

RmiAgentLifeCycleService, RmiAgentLoggingService, RmiPlatformPersistenceService, RmiPlatformSupportService, RMIVerifiableDirectoryService, RMIVerifiableNamingService

All Known Implementing Classes:

AbleBasicService, RmiAgentLifeCycleSystem, RmiAgentLoggingSystem, RmiPlatformPersistenceSystem, RmiPlatformSupportServiceSystem, RMIVerifiableDirectorySystem, RMIVerifiableNamingSystem

public interface RmiAblePlatformService

extends java.rmi.Remote, RmiAblePlatformServiceEventGenerator

This interface is implemented by remote platform services provided by ABLE.

See Also:

AblePlatformService

Method Summary

int	getState() Gets the current state of this service.
void	terminateService(AbleSecureKey theSecureKey) Terminates this service in a controlled way; the service is removed from the service root and, if necessary, unbound from the RMI registry and unexported as a remote RMI object.

Methods inherited from interface com.ibm.able.platform.RmiAblePlatformServiceEventGenerator

addAblePlatformServiceEventListener, getAblePlatformServiceEventListeners, removeAblePlatformServiceEventListener

Method Detail

terminateService

public void terminateService(AbleSecureKey theSecureKey)
                      throws java.rmi.RemoteException,
                             javax.agent.service.naming.NamingException

Terminates this service in a controlled way; the service is removed from the service root and, if necessary, unbound from the RMI registry and unexported as a remote RMI object.

Parameters:

theSecureKey - When security if off, this may be null as the parameter is ignored; when security is on the security key must be from an object with equal or greater authority in order for the operation to proceed.

Throws:

java.rmi.RemoteException - On any RMI error.

javax.agent.service.naming.NamingException

getState

public int getState()
             throws java.rmi.RemoteException

Gets the current state of this service.

Returns:

The state of this service.

Throws:

java.rmi.RemoteException - On any RMI error.