Example 11 – Working in Remote Workspaces

Agents can join workspaces that are hosted on remote nodes, by means of a joinRemoteWorkspace action (provided by the NodeArtifact. As soon as the join succeed, the interaction within remote workspaces is the same as local workspace. In the following example, a Jason agent joins the default workspace of a CArtAgO node running on localhost.
The following Java program installs a CArtAgO node on localhost, to make it reachable (also) by remote agents:

package examples;

import cartago.*;
import cartago.util.BasicLogger;

public class Ex00a_HelloRemoteWorld {

  public static void main(String[] args) throws Exception {
    CartagoService.registerLogger("default",new BasicLogger());
    System.out.println("CArtAgO Node Ready.");


  • Starting a CArtAgO Node: to execute CArtAgO artifact-based environment, first of all a CArtAgO node must be started. This is done by the startNode service of CartagoService. The node functions as virtual machine for running workspaces and artifacts, it does not include any infrastructural (network) support.
  • Installing infrastructure layers: in order to allow agents working in the local node to interact also with remote nodes – or to allow linking with remote artifacts – a proper infrastructural layer must be installed by means of installInfrastructureLayer, specifying the protocol(s) to be used (default means the default protocol of the platform, which is RMI in the case of Java SE desktop environments).
  • Intalling infrastructure services: in order to make the node reachable from remote agents, then infrastructure services must be started by means of startInfrastructureService, again specifying the protocol.

Then, it follows the Jason program which creates a standalone CArtAgO node with a single agent:

MAS example11_remote {


  voyager agentArchClass c4jason.CAgentArch;

  classpath: "../../../lib/cartago.jar";"../../../lib/c4jason.jar";

The voyager agent boots in the standalone node, then it joins a remote workspace, where he creates and uses an artifact.


  <- ?current_wsp(Id,_,_);
     println("testing remote..");
     println("hello there ",WName);

  <- makeArtifact("c0","examples.Counter",[],Id);

  <- ?default_wsp(Id);
     println("count changed: ",V)[wsp_id(Id)].

-!use_remote [makeArtifactFailure("artifact_already_present",_)]
  <- ?default_wsp(WId);
     println("artifact already created ")[wsp_id(WId)];


  • Infrastructure options: By default, Jason programs using CArtAgO environment create a standalone CArtAgO node, i.e. not accessible through the network, and install the default infrastructure layer (RMI) for joining remote workspaces. Besides the default CArtAgO installation, Jason programs have the possibility to work with CArtAgO environment technology in four different ways specifying a set of parameters in the c4jason.CartagoEnvironment definition inside the Jason mas2j file:
    • c4jason.CartagoEnvironment("standalone", protocol(ProtName), ...): analogous to the default installation except for the declaration of one (or more) infrastructure layers that specify the protocols used for working with remote workspaces (ex:   c4jason.CartagoEnvironment("standalone",protocol(lipermi)).
    • c4jason.CartagoEnvironment("infrastructure",protocol(ProtName), ...,service(ServName)): installs a CArtAgO node accessible through the network. The default service protocol supported by the node is RMI, other service protocols can be installed specifying one or more service attributes. RMI is installed as the default protocol for joining remote workspaces but other protocols can be installed as well using the protocol attribute (ex:  c4jason.CartagoEnvironment ("infrastructure", service("lipermi"), protocol("lipermi"))).
    • {c4jason.CartagoEnvironment("remote", WspName, WspAddress, protocol(ProtName, Address), ...): does not install any node – agents directly join the specified remote workspace.
      As usual RMI is installed by default and further protocols can be specified using the protocol attribute
      (ex: c4jason.CartagoEnvironment("remote", "myWsp", "localhost",protocol("lipermi"))).
    • c4jason.CartagoEnvironment("local",WspName) does not install any node – agents directly join the specified local workspace (or the default workspace if no workspace name is specified) (ex:  c4jason.CartagoEnvironment(“local”, “WspName”)).

Leave a Reply

Your email address will not be published. Required fields are marked *


You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>