All Superinterfaces:

Serializable, Serializable, Service.Slice

All Known Implementing Classes:

AgentManagementProxy
```
public interface AgentManagementSlice
extends Service.Slice
```
The horizontal interface for the JADE kernel-level service managing the basic agent life cycle: creation, destruction, suspension and resumption.

Author:

Giovanni Rimassa - FRAMeTech s.r.l.

Field Summary

Fields
Modifier and Type	Field	Description
`static String`	`ADD_TOOL`	This command name represents the action of adding a new tool to the platform.
`static boolean`	`CREATE_AND_START`
`static boolean`	`CREATE_ONLY`
`static String`	`H_BORNAGENT`
`static String`	`H_CHANGEAGENTSTATE`
`static String`	`H_CREATEAGENT`
`static String`	`H_DEADAGENT`
`static String`	`H_EXITCONTAINER`
`static String`	`H_KILLAGENT`
`static String`	`H_RESUMEDAGENT`
`static String`	`H_SUSPENDEDAGENT`
`static String`	`INFORM_CREATED`	This command is issued by an agent that has just been created, and causes JADE runtime to actually start up the agent thread.
`static String`	`INFORM_KILLED`	This command is issued by an agent that has just been destroyed and whose thread is terminating.
`static String`	`INFORM_STATE_CHANGED`	This command is issued by an agent that has just changed its life-cycle state.
`static String`	`KILL_CONTAINER`	This command name represents the `kill-container` action.
`static String`	`NAME`	The name of this service.
`static String`	`REMOVE_TOOL`	This command name represents the action of removing an existing tool from the platform.
`static String`	`REQUEST_CREATE`	This command name represents the `create-agent` action.
`static String`	`REQUEST_KILL`	This command name represents the `kill-agent` action.
`static String`	`REQUEST_STATE_CHANGE`	This command name represents all agent management actions requesting a change in the life cycle state of their target agent (suspend, resume, etc.).
`static String`	`SHUTDOWN_PLATFORM`	This command name represents the `shutdown-platform` action.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`bornAgent(AID name, ContainerID cid, Command sourceCmd)`
`void`	`changeAgentState(AID agentID, int newState)`
`void`	`createAgent(AID agentID, String className, Object[] arguments, JADEPrincipal owner, Credentials initialCredentials, boolean startIt, Command sourceCmd)`
`void`	`deadAgent(AID name, Command sourceCmd)`
`void`	`exitContainer()`
`void`	`killAgent(AID agentID, Command sourceCmd)`
`void`	`resumedAgent(AID name)`
`void`	`suspendedAgent(AID name)`

Methods inherited from interface jade.core.Service.Slice
getNode, getService, serve

- Field Detail
  - NAME
```
static final String NAME
```
    The name of this service.
    
    See Also:
    
    Constant Field Values
  - REQUEST_CREATE
```
static final String REQUEST_CREATE
```
    This command name represents the create-agent action. The target agent identifier in this command is set to null, because no agent exists yet. This command object represents only the first half of the complete agent creation process. Even if this command is accepted by the kernel, there is no guarantee that the requested creation will ever happen. Only when the InformCreated command is issued can one assume that the agent creation has taken place.
    
    See Also:
    
    Constant Field Values
  - REQUEST_KILL
```
static final String REQUEST_KILL
```
    This command name represents the kill-agent action. This command object represents only the first half of the complete agent destruction process. Even if this command is accepted by the kernel, there is no guarantee that the requested destruction will ever happen. Only when the InformKilled command is issued can one assume that the agent destruction has taken place.
    
    See Also:
    
    Constant Field Values
  - REQUEST_STATE_CHANGE
```
static final String REQUEST_STATE_CHANGE
```
    This command name represents all agent management actions requesting a change in the life cycle state of their target agent (suspend, resume, etc.). This command object represents only the first half of the complete agent state change process. Even if this command is accepted by the kernel, there is no guarantee that the requested state change will ever happen. Only when the InformStateChanged command is issued can one assume that the state change has taken place.
    
    See Also:
    
    Constant Field Values
  - INFORM_CREATED
```
static final String INFORM_CREATED
```
    This command is issued by an agent that has just been created, and causes JADE runtime to actually start up the agent thread. The agent creation can be the outcome of a previously issued RequestCreate command. In that case, this command represents only the second half of the complete agent creation process.
    
    See Also:
    
    Constant Field Values
  - INFORM_KILLED
```
static final String INFORM_KILLED
```
    This command is issued by an agent that has just been destroyed and whose thread is terminating. The agent destruction can either be an autonomous move of the agent or the outcome of a previously issued RequestKill command. In the second case, this command represents only the second half of the complete agent destruction process.
    
    See Also:
    
    Constant Field Values
  - INFORM_STATE_CHANGED
```
static final String INFORM_STATE_CHANGED
```
    This command is issued by an agent that has just changed its life-cycle state. The agent state change can either be an autonomous move of the agent or the outcome of a previously issued RequestStateChange command. In that case, this command represents only the second half of the complete agent state tansition process.
    
    See Also:
    
    Constant Field Values
  - SHUTDOWN_PLATFORM
```
static final String SHUTDOWN_PLATFORM
```
    This command name represents the shutdown-platform action. This command has no effect but informing interested services that the platform shutdown process is starting.
    
    See Also:
    
    Constant Field Values
  - KILL_CONTAINER
```
static final String KILL_CONTAINER
```
    This command name represents the kill-container action.
    
    See Also:
    
    Constant Field Values
  - ADD_TOOL
```
static final String ADD_TOOL
```
    This command name represents the action of adding a new tool to the platform.
    
    See Also:
    
    Constant Field Values
  - REMOVE_TOOL
```
static final String REMOVE_TOOL
```
    This command name represents the action of removing an existing tool from the platform.
    
    See Also:
    
    Constant Field Values
  - CREATE_AND_START
```
static final boolean CREATE_AND_START
```
    See Also:
    
    Constant Field Values
  - CREATE_ONLY
```
static final boolean CREATE_ONLY
```
    See Also:
    
    Constant Field Values
  - H_CREATEAGENT
```
static final String H_CREATEAGENT
```
    See Also:
    
    Constant Field Values
  - H_KILLAGENT
```
static final String H_KILLAGENT
```
    See Also:
    
    Constant Field Values
  - H_CHANGEAGENTSTATE
```
static final String H_CHANGEAGENTSTATE
```
    See Also:
    
    Constant Field Values
  - H_BORNAGENT
```
static final String H_BORNAGENT
```
    See Also:
    
    Constant Field Values
  - H_DEADAGENT
```
static final String H_DEADAGENT
```
    See Also:
    
    Constant Field Values
  - H_SUSPENDEDAGENT
```
static final String H_SUSPENDEDAGENT
```
    See Also:
    
    Constant Field Values
  - H_RESUMEDAGENT
```
static final String H_RESUMEDAGENT
```
    See Also:
    
    Constant Field Values
  - H_EXITCONTAINER
```
static final String H_EXITCONTAINER
```
    See Also:
    
    Constant Field Values
- Method Detail
  - createAgent
```
void createAgent(AID agentID,
                 String className,
                 Object[] arguments,
                 JADEPrincipal owner,
                 Credentials initialCredentials,
                 boolean startIt,
                 Command sourceCmd)
          throws IMTPException,
                 NotFoundException,
                 NameClashException,
                 JADESecurityException
```
    Throws:
    
    IMTPException
    
    NotFoundException
    
    NameClashException
    
    JADESecurityException
  - killAgent
```
void killAgent(AID agentID,
               Command sourceCmd)
        throws IMTPException,
               NotFoundException
```
    Throws:
    
    IMTPException
    
    NotFoundException
  - changeAgentState
```
void changeAgentState(AID agentID,
                      int newState)
               throws IMTPException,
                      NotFoundException
```
    Throws:
    
    IMTPException
    
    NotFoundException
  - bornAgent
```
void bornAgent(AID name,
               ContainerID cid,
               Command sourceCmd)
        throws IMTPException,
               NameClashException,
               NotFoundException,
               JADESecurityException
```
    Throws:
    
    IMTPException
    
    NameClashException
    
    NotFoundException
    
    JADESecurityException
  - deadAgent
```
void deadAgent(AID name,
               Command sourceCmd)
        throws IMTPException,
               NotFoundException
```
    Throws:
    
    IMTPException
    
    NotFoundException
  - suspendedAgent
```
void suspendedAgent(AID name)
             throws IMTPException,
                    NotFoundException
```
    Throws:
    
    IMTPException
    
    NotFoundException
  - resumedAgent
```
void resumedAgent(AID name)
           throws IMTPException,
                  NotFoundException
```
    Throws:
    
    IMTPException
    
    NotFoundException
  - exitContainer
```
void exitContainer()
            throws IMTPException,
                   NotFoundException
```
    Throws:
    
    IMTPException
    
    NotFoundException

Interface AgentManagementSlice

Field Summary

Method Summary

Methods inherited from interface jade.core.Service.Slice

Field Detail

NAME

REQUEST_CREATE

REQUEST_KILL

REQUEST_STATE_CHANGE

INFORM_CREATED

INFORM_KILLED

INFORM_STATE_CHANGED

SHUTDOWN_PLATFORM

KILL_CONTAINER

ADD_TOOL

REMOVE_TOOL

CREATE_AND_START

CREATE_ONLY

H_CREATEAGENT

H_KILLAGENT

H_CHANGEAGENTSTATE

H_BORNAGENT

H_DEADAGENT

H_SUSPENDEDAGENT

H_RESUMEDAGENT

H_EXITCONTAINER

Method Detail

createAgent

killAgent

changeAgentState

bornAgent

deadAgent

suspendedAgent

resumedAgent

exitContainer