Protocol
The ComManager of a Magenta Agent spends most of its time listening on its assigned port for messages from other Agents. Messages tell the receiving Agent to carry out one of a small set of possible actions. The return value of the command is then returned to the Agent which sent the message.The formats for each of these commands and the expected reply is presented below.
create*classname*parent-node*object-name
Creates an object in the ObjectManager?. All of the parameters have defaults: classname defaults to magenta.GdmoObject, parent-node defaults to root, object-name defaults to concatenation of classname and instancenumber (e.g. magenta.GdmoObject3?). The expected replies are:
- create failure reason-string
- create success object-full-name
set*object-full-name*attribute*value
Set an attribute of a local object. None of the parameters have defaults.The expected replies are:
- set failure reason-string
- set success
get*object-full-name*attribute
Get an attribute of a local object. All of the parameters have defaults: object-full-name defaults to root and attribute defaults to Name.The expected replies are:
- get failure reason-string
- get success object-full-name::attribute=value
delete*object-full-name
Delete a local object and any objects beneath it in the tree. None of the parameters have defaults.The expected replies are:
- delete failure reason-string
- delete success object-full-name (object that was deleted)
Print the contents of the ObjectManager?.The expected reply is an ordered listing of the contents of the ObjectManager? in the format:
object1-full-name [class: classname name: node-name attribute1: attribute1-value attribute2: attribute2-value] :: object2-full-name…etc.
for example:
root [class: CLIManager name: root HostInfo: localhost:4444] :: root/magenta.GdmoObject0? [class: magenta.GdmoObject name: magenta.GdmoObject0?] ::