APPENDIX H: TCL PROGRAMMING G UIDE 137Accessing TCL WindowThe TCL Interpreter can be accessed through RaritanConsole using the Script menu selection, as describedin Chapter 4: Console Features.The TCL prompt is “%”. The command(s) to be executed must be entered AFTER the prompt. The resultwill be echoed on the next new line. The user may execute multiple-line commands using the Copy andPaste features from the Windows/Unix operating system.Note: Any response that is larger than 4K will not be echoed back to the user, but the command’s outputmay be stored in a variable.Figure 125 Activating TCL Scripting WindowResetting TCL InterpreterTCL scripts may have forever-loops due to programming errors, unknown conditions, or by design. Whenthis condition occurs, click on the [Reset] button in the scripting window to halt the execution of the TCLscript. However, not all conditions are recoverable by clicking on the [Reset] button. Therefore, fullsoftware reset from the GUI may be necessary to restart the interpreter.When a Reset has been issued to the TCL Interpreter, the BOOT.SCR will NOT be executed. This willprevent errors in the boot script from incapacitating the interpreter. Not all conditions are recoverable byReset. The user may have to execute a factory reset to remove the error condition. When factory resetoccurs, boot.scr is renamed boot.bak. Administrations will need to rename boot.bak to boot.scr once thefactory reset is complete.Editing TCL ScriptsThe TCL Shell includes a built-in editor, activated by typing edit at the % prompt. The filewill be saved to the directory in which the TCL interpreter is currently operating. Administrators, Operators,and TCL script developers should understand the mechanisms by which Write Access is obtained andreleased in order to develop applications to manage target devices.Note: The TCL engine owns files created by the users. Removing a user account does not delete anycreated files.Executing TCL ScriptsA stored TCL Script may be executed as follows.% source