+xns/Hosting
Message: HostAgent

+xns/Core/XNSObject
   |
   +--+xns/Core/Message
         |
         +--+xns/Hosting/HostAgent


Establishes a relationship between an agent and the agent that will function as its host.

This message is sent to the agent that is to function as a host agent. A host agent shares all its URIs with the agents it hosts.

An input agent is optional. If an input agent is provided, then the input agent will be hosted by the agent receiving the message. If no input agent is provided, then a new agent is created and hosted by the agent receiving the message. The input or new agent will receive communication via the same URIs as the host agent (see @xns/ID/Register.)

This message returns the agent address based upon the new hosting environment.

To: Host agent.
From: Any agent or exposure.


 

Input
+xns/Data/Agent Agent The data of the agent that is to be hosted.
 

Output
+xns/Core/AgentAddress AgentAddr The agent's new address with its host.
 

Input Detail

Agent

The data of the agent that is to be hosted.  

DataType: +xns/Data/Agent
 


 

Output Detail

AgentAddr

The agent's new address with its host.  

DataType: +xns/Core/AgentAddress
 


Publishing Agent: +xns Last Updated: 07/09/2002