----------------------------------------------------------- README for Citrix Tcl/Tk ICA Stress Test Launcher 0.9 build 14 December 1999 ----------------------------------------------------------- (c) Copyright Citrix Systems, Inc 1999 This document contains informaton on the Citrix Tcl/Tk ICA Stress Test Launcher version 0.9 build 14. CONTENTS ======== SYSTEM REQUIREMENTS Disk Space requirements SETUP Installing the Stress Test Launcher application RUNNING THE APPLICATION ADDITIONAL ISSUES TO DO HISTORY CONTACTS CONDITIONS OF USE SYSTEM REQUIREMENTS =================== To run the Citrix Tcl/Tk ICA Stress Test Launcher you need the following:- For Windows 95, Windows 98 or Windows NT 4.0 - A 486 with a 66 MHz processor - For Windows 95/98: 16 MB RAM minimum - For Windows NT 4.0 32 MB RAM minimum Service pack 3 or later recommended - 7 MB hard disk space (for the Tcl/Tk interpreter) - Tcl/Tk 8.0 or later (8.2 recommended) - Mouse For the Macintosh System 7.1 or later - Macintosh or PowerMacintosh - For Macintosh 4 MB RAM minimum - For PowerMacintosh 16 MB RAM minimum - 68K requires the CFM-68K enabler (included in the MacTk installation) - 6 MB hard disk space (for the Tcl/Tk interpreter) - Tcl/Tk 8.0 or later (8.2 recommended) - Mouse For UNIX Any one of variety of UNIX Operating Systems (Visit http://www.scriptics.com to see if yours is supported) - Most hardware platforms Supported - 16 MB RAM - 10 MB hard disk space (for the Tcl/Tk interpreter) - Tcl/Tk 8.0 or later (8.2 recommended) - Mouse SETUP ===== To install the Stress Test Launcher make a directory/folder on your hard disk called "Stress_test" and copy the files stress_09.tcl and ctx_logo.gif to the directory/folder you have created. Additionally, on the Macintosh a folder must exist at the top level of your startup disk called "CitixICAConnections", that contains the .ICA file specifying the connection that you wish to make. RUNNING THE APPLICATION ======================= In Windows, just double click on stress_09.tcl. In UNIX, make sure that wish is in your PATH. Then at the command line type wish stress_09.tcl to run the application. When you type in the path in the path field, use the forward slash rather than the back slash. In Macintosh, open Wish, and then the Tcl source file, stress_09.tcl, from within Wish. Additional Performance will be gained by launching the ICA Client application before running the script. The Iterations Passed shows the tested completed. If Infinite is checked then Iterations Passed shows the actual number completed to date KNOWN ISSUES ================= The application currently runs on all platforms, although some platform specific issues persist. Windows ------- UNIX ---- Macintosh --------- -A loading error of the Applescript shared library on the PowerMacintosh is reported. This will be fixed in a later release. -The Macintosh version can also only launch a .ICA file pointing to the logoff published application on the server, using the default filename of "Logoff" in the default folder that must exist at the top level of your startup disk called "CitixICAConnections": This is a limitation of the AppleScript handling of the Mac version of Tcl/Tk 8.2.1 as the Apple script implementation is unable to access $path & $ica vars. - Removing focus (takefocus 0) from disabled text fields on Macintosh, maybe others too, doesn't work - Use space bar on Mac for OK instead of Return TO DO ===== - Server side support (also written in TCL) - Resolve AppleScriptlib issue on Power Macintosh (68k ok) - Better Error Handling - Current focus not shown on entry, checkbutton nor button - Add logo to About box HISTORY ======= - version 0.9 build 14 : Restructured window hierachy Added Close function to menu Restructured splash screen Added version info label to splash screen Changed window title removed parameters from launch corrected win path Changed default Windows path to c:\Program files\citrix\wfcmgr32 - version 0.9 build 12 : [Proc: Move TO DO's to HISTORY as completed] Updated 0.9b11 HISTORY Reversed order of HISTORY Tested on 68k Macintosh. Renamed to Citrix ICA É Added STRUCTURE and PSUEDO CODE to file "Functional Requirements and Implementation" Changed credits in source and readme Added Current Iteration label on panel [.curitrtnlbl, curitrtnentry] Expaned brackets ( not poss with: if, elseif, foreach, proc) Comments window setup. Increased splash timeout from 900 to 3500 /*and moved to after panel init*/ Renamed logo file: citix_compute.gif -> ctx_logo.gif - 8.3 filename syntax Removed refs to beta build, i.e. '.b10' in file name. Removed "not working on Macintosh" Added Macintosh to RUNNING THE APLICATIONS Moved "Not Needed on Macintosh" message in path Text Field (static) instead of label, then Using path on macintosh, changed "Not Needed on Macintosh" message to default "Citrix ICA Connections Moved initial window under Macintosh menu. Added Current Iteration indicator to launch panel (.frame4) (right justified and disabled) Added iteration variable: curitrtn renamed x and made curitrtn global in proc launchICA: now functional Moved default path out of Macintosh loop to save on code - requires compromise between UNIX and Mac filenames (no spaces allowed etc.) : "Citrix ICA Connections" -> "Citrix_ICA_Connections" -> "CitrixICAConnections" -> ??? Added default ICA connection filename: "logoff" Added section 2a for variable initialisation Added colon to iterations slide label Made html docs, added mailto: link Move set cmd to UNIX part of proc, as only used there - unification needed in filename of ICA app. cmd var necessary for function of UNIX Made AppleScript launch more Scriptish (tell application "Finder";activate;end tell) Got launch working on mac without vars ($ not accessable within applescript exec?), using definite path and filename Moved launch delay to end of for loop Added infinite loops checkbox, and while, no do unfortunately Removed variable refs to splash and .label Added default outline to "launch" button Disabled path and filename text fields for Macintosh Added variable delay Added big increment Removed while and used OR in for Disabled launch button during test Changed current iteration to iterations passed Removed .s and .lbl for memory Passing path and ica as parameters bound to correct proc Defaults for path: Mac: 'Not_Needed' PC: 'C:\' UNIX: '/usr/lib/ICAClient' Added Launch button default focus Destroyed Splash after init - version 0.9 build 11 : Added the slogan "Now Everything Computes" to the Citrix logo. Removed Focus of slider (via set tk_strictMotif 1) Reduced splash timeout from 4200 to 900. - version 0.9 build 10 : Added the Citrix logo for the splash screen. - version 0.9 build 9 : Added code for splash screen. Fixed problem with Linux. This was due to my .login profile settings! - version 0.9 build 8 : Tidied up code. Build not released as beta. - version 0.9 build 7 : Added Macintosh and UNIX support (I think!). Sort of works on UNIX. - version 0.9 build 6 : Released (6 Dec 1999) CONTACTS ======== Any comments please feel free to email us at : colin.ling@eu.citrix.com, mark.jenkins@eu.citrix.com CONDITIONS OF USE =============== This software is open source. Please feel free to modifiy it as you please. Just include this readme (with amendments but no deletions) with future distributions.