brahms.base.system
Class CreateExternalAgentActivity

java.lang.Object
  gov.nasa.arc.brahms.vm.api.jac.AbstractExternalActivity
      brahms.base.system.CreateExternalAgentActivity

All Implemented Interfaces:

IExternalActivity

public class CreateExternalAgentActivity
extends AbstractExternalActivity

The CreateExternalAgentActivity allows a modeler to dynamically create a new external agent. The modeler must provide the fully qualified Java class name with the implementation for the Java agent and optionally specify the base name to assign to the external agent. The Brahms virtual machine will add additional information to the name to guarantee name uniqueness.

This activity requires three parameters in the Brahms java activity declaration:

• string classname (the fully qualified classname for the Java class with the agent implementation)
• symbol agentname (optional, the name to assign to the agent)
• ActiveInstance out (the created agent)
• symbol outfqn (optional, the fully qualified name assigned to the agent)

Version:

$Revision: 1.1 $ $Date: 2007/10/10 14:02:53 $ $Author: rvhoof $

Author:

Ron van Hoof

Constructor Summary

CreateExternalAgentActivity()

Method Summary

void	doActivity() Executes the java activity action.

Methods inherited from class gov.nasa.arc.brahms.vm.api.jac.AbstractExternalActivity

assertBelief, assertFact, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, getContext, getModel, getName, getParameter, getParameterCount, getPerformedBy, getVMController, getWorldState, isValidTruthValue, retractBelief, retractFact, send, send, send, send, setActivity, setProperties, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CreateExternalAgentActivity

public CreateExternalAgentActivity()

Method Detail

doActivity

public void doActivity()
                throws ExternalException

Executes the java activity action.

Specified by:

doActivity in interface IExternalActivity

Specified by:

doActivity in class AbstractExternalActivity

Throws:

ExternalException - if an unrecoverable error occurs.