Getting Started with Integration into Together ControlCenter

Prerequesites

For performing all the subsequent steps successfully, make sure the following software requirements are met:

• Java SDK 1.3 or higher (SDK 1.3 recommended)
• Jakarta Ant build tool (any version from 1.4 onwards is believed to suffice)
• Borland Together ControlCenter version 6.0 and above

1.) Getting sources from CVS

ATTENTION: Note that the CVS of the Dresden OCL2 Toolkit is outdated and will be now longer updated. Now, the Dresden OCL2 Toolkit uses SVN. For further details regarding SVN look into the download section.

The following instructions presume usage of a simple command line CVS client. You can of course use your favorite graphical CVS client such as WinCVS instead. When encountering problems, please refer to the documentation on SourceForge on checking out from CVS.

1. Log anonymously into the CVS repository by typing (all in one line)
   cvs -d:pserver:anonymous@cvs.sourceforge.net: /cvsroot/dresden-ocl login
   (when asked for the password, just hit 'Enter')
   
   
2. Check all sources out that you need:
   cvs -d:pserver:anonymous@cvs.sourceforge.net: /cvsroot/dresden-ocl checkout src -P
   
   
3. And the build file:
   cvs -d:pserver:anonymous@cvs.sourceforge.net: /cvsroot/dresden-ocl checkout build.xml

2.) Build module

{BASE-DIR} denotes the directory you have checked the sources out into. If your work directory during the checkout has been c:\dresden-ocl then that is your base directory.

1. Build the module by typing:
   {BASE-DIR}/ant jar.ocl-together
   
   
2. After successfull completion you should be able to find a file ocl-together.jar in {BASE-DIR}/build.

3.) Getting module to work in Together

{TOGETHER-BASE-DIR} denotes your copy of Together ControlCenter's base directory.

1. Create a directory dresden-ocl as subdirectory in {TOGETHER-BASE-DIR}/modules/com/togethersoft/modules (the name you choose for that directory doesn't really matter).
   
   
2. Copy the file {BASE-DIR}/build/ocl-together.jar into {TOGETHER-BASE-DIR}/modules/com/togethersoft/modules/dresden-ocl.
   
   
3. Start Together ControlCenter.
   
   
4. Choose Tools --> Activate/Deactivate Features and check OCL Editor and OCL Injector in the Early Access tab.
   
   
5. When you now choose a class or interface on the diagram pane you should see an additional tab labeled OCL Constraints in the Inspector where you can now add OCL constraints.