Raritan Dominion SX16, Installation And Operation Manual, Page: 137 / 162

A
PPENDIX
I: TCL P
ROGRAMMING
G
UIDE
123
Accessing TCL Window
The TCL Interpreter can be accessed through RaritanConsole using the Script menu selection, as described in
Chapter 4: Console Features .
The TCL prompt is “%”. The command(s) to be executed must be entered AFTER the prompt. The result will be
echoed on the next new line. The user may execute multiple-line commands using the Copy and Paste 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
output may be stored in a variable.
Figure 125 Activating TCL Scripting Window
Resetting TCL Interpreter
TCL scripts may have forever-loops due to programming errors, unknown conditions, or by design. When this
condition occurs, click on the [
Reset ] button in the scripting window to halt the execution of the TCL script.
However, not all conditions are recoverable by clicking on the [ Reset ] button. Therefore, full software 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 will prevent
errors in the boot script from incapacitating the interpreter. Not all conditions are recoverable by Reset . The user
may have to execute a factory reset to remove the error condition. When factory reset occurs, boot.scr is renamed
boot.bak. Administrations will need to rename boot.bak to boot.scr once the factory reset is complete.
Editing TCL Scripts
The TCL Shell includes a built-in editor, activated by typing edit <filename> at the % prompt. The file will 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 and released 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
any created files.