RETSINA Tutorial Joseph Giampapa MSEC Fall 2001

Overview Installing the Software Configuring the Infrastructure Developing an Agent Running an Agent Debugging and Development Tools Useful Agents to Know

Installing the Software For C/C++ Development –Windows 2000 –Unix - to be released For Java Development –Windows 2000 –Unix – to be released

Installing the RETSINA AFC SDK on Windows 2000 Preferable System Requirements Software Dependencies Installation Procedure Joseph Giampapa MSEC Fall 2001

Software Dependencies 1.install Visual Studio 6.0, Visual C++ –You should be Administrator 2.install MSDN - Microsoft Developer Network –You should be Administrator 3.install the RETSINA AFC SDK You should be the local user, i.e. garof

Preferable System Requirements Windows M RAM, or more 885M Disk for MS Visual Studio 6.0 –VB, VC, & MSDN –May be less 95M Disk for RETSINA –AFC SDK, Tools + some Agents

AFC SDK Installation Procedure 1.Initialize Directory Structure 2.Setup the RETSINA Variable 3.Install DLLs 4.Install Common System Files 5.Configure Visual C/C++ 6.Start the MFC Visual Studio

1. Initialize Directory Structure 1.put CD in CD reader 2.click through the menus... 3.There is only one obvious path to success

2. Setup the RETSINA Variable System-wide, so that it will be the same for every user 1.login as Administrator 2.start  settings  control panel  system  advanced  environment variables  System variables  new 3.variable name: RETSINA 4.value: the AFC parent directory Example: –if the path to AFC is c:\Program Files\RETSINA\AFC –then the value for the RETSINA variable is c:\Program Files\RETSINA 5.DO NOT end the path name with a slash

2.1. RETSINA Variable Verification To verify the values of the system variables: 1.open a DOS prompt, and 2.type “set”. 3.It will display all the known variables and their values. 4.Access the variable by “quoting” it with percent- signs: %RETSINA%

3. Install DLLs under Windows 1.login as Administrator 2.cd %RETSINA%\AFC\lib\dll\debug 3.click to activate the “install.bat” file

4. Install Common System Files 1.login as Administrator 2.start  run  d:\RETSINAsystemfiles.exe 3.Browse the CD-ROM and select the file named “RETSINAsystemfiles.exe” N.B.: your file manager may be configured to not show file name extensions 4.Run the selected executable

5. Configuring Visual C/C++ 1.login as user (e.g. garof) 2.start  programs  accessories  windows explorer WARNING: The view from “My Computer” will only permit you to launch the “InstallShield Wizard”, so you need to use “Windows Explorer” 3.Copy “D:\MFC RetsinaAgent.awx” to “ C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\IDE”

6. Start the MFC Visual Studio 1.login as user (e.g. garof) 2.Start  Programs  Microsoft Visual Studio 6.0  Microsoft Visual C from within the Microsoft Visual C++ application, select: Tools  Options...  Directories illustrated on page 4 of AFC Developer’s Guide 4.From within the Options pop-up dialogue box, select: 1.empty line -> click within it -> and browse [...] 2.C:\PROGRAM FILES\RETSINA\AFC\INCLUDE 3.[OK]

AFC SDK Setup is Compete Setup is now complete. Now it is possible to create agents. Please monitor the AFC distribution web site for updates.AFC distribution web site

Installing the Software for Java Development Windows 2000 –Software Dependencies –Installation Procedure Unix – to be released

Software Dependencies 1.Jdk recommended –Available on course web pagecourse web page –Requires 22.2M of free disk 2.jdk 1.3.1_01 - optional –Download from –Requires 60M of free disk –Will not run ANS from current jar 3.Specific jar files and instructions –Available on course web pagecourse web page

Configuring the Infrastructure Agent Name Services 1.Win32ANS - Windows only 2.AgentNameService - Java-based for Windows and Unix Logging and Visualization 1.Windows-based DemoDisplay 2.Applet-based DemoDisplay - per request Matchmakers – at a later date 1.Gin-based Matchmaker 2.A-Match Matchmaker 3.LARKS Matchmaker

Developing an Agent Recommended Text Editors –MS Visual Studio for AFC SDK –Text-only editors for Java-based development Emacs 20.7 is the bestEmacs 20.7 Notepad and WordPad are OK if used only in Text mode in AFC in Java –Demonstration at a later date –Please see me if you need immediate help

Developing in AFC SDK You can build you agents in any subdirectory. –For convenience: “%RETSINA%\Agents” Use AFC AppWizard –Page 41 of “AFC Developer’s Guide” –A 4-step process

Starting the Agent AppWizard From within MS Visual C++: 1.File  New  MFC Retsina Agent AppWizard 2.For “Project Name”, enter an agent name: Test_01 3.Change the “Location:” directory to “%RETSINA%\Agents” Notice that Visual C will create another subdirectory, based on your agent name: “%RETSINA%\Agents\Test_01” Click [OK]

MFC Retsina Agent AppWizard – Step 1 You will be prompted to select an application type: To the left of the radio button window, you will see a visualization of each of those choices. At this time, only “Dialog based” is implemented. Select “Dialog based” and click [Next >].

MFC Retsina Agent AppWizard – Step 2 of 4 This menu allows you to select a label for your agent’s GUI title bar. Please enter a title for your dialogue: Test_01 [Next >]

MFC Retsina Agent AppWizard – Step 3 of 4 The only option, leave as is. You choice: comments are better. The only option that you can select. This feature is not yet implemented. Please click [Next >] when you are ready to proceed.

MFC Retsina Agent AppWizard – Step 4 of 4 This window gives you the chance to change the names of the files. Use the defaults, for now. Please click [Finish] when ready.

MFC Retsina Agent AppWizard Confirmation Box You will see a review box, labeled “New Project Information”.

Important Final Steps Before you begin modifying your agent, you need to manually copy some library files into your project repository.

Running an Agent

Debugging and Development Tools testANS and TestANSGUI kqmlcenter and KQMLMessageSenderGUI ACLParserTestbed - ACLExplorer

Useful Agents to Know MediaAgent RPA MokSAF SpeechAgent SpeechBroker Others, at a later date