Creating and Manipulating a New ACME Representation

Before beginning this lesson, you should already be familiar with the contents of Lesson 1. You should also be have launched Graphlet and be connected to the ACME Server as described in the introduction.


Creating a New Top Level System

If there is no existing system and you are creating one from scratch, the first thing you must do after connecting to the server is to create a new top level system. This is accomplished by selecting the Morale->New ACME System... menubar selection item. This will activate the new system dialog where you may enter a name for the ACME Top Level System. In the first text box enter the name of the ACME system, and in the Type list box select the system type by clicking on it. For totally new ACME Systems, you will only have the choice of clicking on None. Then press OK to accept.

For the tutorial, name the system Test_Sys and click None, then OK.


Creating New Components

To create components, first ensure Graphlet is edit mode by pressing the top button on the left vertical column of buttons (the line between two dots). Now move the mouse pointer over the area where you want the component drawn and press the left mouse button. This will activate the add new component dialog.

Enter the component name in the text box and select the appropriate component type. Again, for totally new ACME descriptions, this entry will generally limited to None. For this tutorial, enter C1 for the name, click None and then press the OK button. This action brings up an additional dialog which allows specification of ports for this component. To enter the ports, simply list them in the entry box separated by a space between each name.

There is also a list on this dialog for default ports. This contains the ports that will be automatically available on this component due to its type. In this example, the component is untyped and so there are no default ports. For the tutorial enter dp1 dp2 in the text box and press the OK button.

Use the same procedure to create a second component called C2 with ports dp45 and api_call.


Creating New Connectors

Now let's create a connector between components C1 and C2. Move the mouse pointer over component C1 and press and hold the left mouse button. Drag the mouse over component C2 and release the left mouse button. This activates the new connector dialog. Just as the other create dialogs, we enter a name and select a type for the new element. For the tutorial, select the name conn1 and click on None and then press OK.

Pressing OK will bring up the Set Connector Attachment dialog which allows you to specify the ACME attachments.

If the connector has an ACME type, the standard type roles will be shown in the role text boxes and you will need only specify the ports by clicking on them. In this case though, there was no connector type so we must manually specifiy the roles. First type put in the first text box, then click on dp2, then type get in the second text box and click on dp45. Finally, press the OK button.

At the conclusion of this step, your display should look something like this:


[Previous] [Next]