How do I run Psyclone AIR Plug?

If you want to try the compiled examples first, you can give the following command (for cpptester):

./cpptester psyclone=localhost

Make sure Psyclone is running first.

To compile the examples you merely enter the following command on the command line

make

This will compile and build the three examples, which you can run manually by first starting up the Psyclone Server without a psySpec in one command window

./psyclone<version>ncl

and in another command windows run the Tester module

./cpptester

If Psyclone is running on a port other than 10000 you will have to specify this by

./cpptester psyclone=localhost:12000

or if Psyclone is running on another computer on the network

./cpptester psyclone=mikescomputer:12000

To include an external module when running Psyclone and have Psyclone help you by starting the module for you automatically you will need to create a psySpec and define a module which provides the full command line with which to start up the external module. For example, to define a module which uses an external module in the executable file mymodule, you would specify the module like this

 <module name="MyModule">
        <description>This module is my first external module</description>
        <parameter name="maxcount" type="Integer" value="100"/>
        <parameter name="anotherparam" type="double" value="0.01"/>
        <parameter name="astringparam" type="String" value="Hello"/>
        <executable name="MyModuleName" consoleoutput="yes">
            ./mymodule psyclone=%host%:%port% name=%name%
        </executable>
        <spec>
            <context name="Psyclone.System.Ready">
                <phase id="1">
                    <triggers from="WB1">
                        <trigger after="100" type="Psyclone.System.Ready"/>
                        <trigger type="Test.Message.Type"/>
                    </triggers>
                    <posts>
                        <post to="WB1" type="Other.Message.Type" />
                    </posts>
                </phase>
            </context>
        </spec>
    </module>

You can even specify multiple command lines if the same psySpec is used on different computers and even different operating systems
<executable name="MyModuleName" consoleoutput="yes">
           <sys hostname="mikescomputer">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
           <sys hostname="brianscomputer">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
           <sys ostype="Linux">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
           <sys ostype="OSX" hostname="johnscomputer">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
        </executable>

More advanced use

Soon to come...