Contents
Back
Forward

Appendix B: Using CSPL Companion


B.1 What is CSPLCompanion?

The CSPL companion is a tool used to help designer in manage CSPL operations, you can find it in Tools subdirectory of CSPL package; up to now it is a simple batch file but, when IŽll find more time it will become a complete stand-alone process.
CSPL Companion has two main functions:
It is used to create templates of csplclient source code files and to automate compiling and linking operations.



B.2 Before starting CSPLCompanion
Before using CSPLCompanion you should install Borland C++ compiler and modify slightly CSPLCompanion.bat file:
Click with right button on CSPLCompanion.bat file and select modify from the pop-up menu; notepad should open with CSPLCompanion.bat file in it; the first three rows should be:

REM PLACE YOUR BORLAND PATH AND CSPL PATH IN THE FOLLOWING BRACKETS
SET BORLANDPATH="BORLAND_PATH_HERE"
SET CSPLPATH="CSPL_PATH_HERE"

Now, as explained by REM line, place the path in which you installed Borland Compiler and the CSPL pack between brackets (so if you intalled the compiler in C:\programs\borland the second row should be changed in SET BORLANDPATH="c:\programs\borland"), now save changes and exit from notepad, youŽre ready to use Companion.



B.3 Using CSPLCompanion
CSPLCompanion can be invoked without any parameter or with a single parameter; the parameter tells CSPLCompanion the working path (the directory in which your source files will be); if no parameter is invoked then the standard working directory (".\WorkSpace") is used.
When CSPLCompanion is launched it will shown the following screen:

CSPLCompanion screenshot

As you can see the third line shows the current working directory, the directory in which subsequent actions will take place.
From this screen the user can copy new CSPL template files in the working directory (overwriting every previously written CSPLClient file) pressing the key A, the user can compile and link the CSPLClient program previously written in working directory pressing the B key while the user can leave the program simply pressing C at this screen (Notice that if working directory doesnŽt exist CSPLCompanion will create one).





Contents / Introduction
Chapter I / Chapter II / Chapter III / Chapter IV / Chapter V / Chapter VI / Chapter VII
Chapter VIII / Chapter IX / Chapter X / Chapter XI / Chapter XII / Chapter XIII
Appendix A / Appendix B / Appendix C