Raritan DOMINION SX - Specifications download pdf (Page 153)

APPENDIX H: TCL PROGRAMMING GUIDE 143

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.

Executing TCL Scripts

A stored TCL Script may be executed as follows.

% source <filename>

1 2 ... 148 149 150 151 152 153 154 155 156 157 158 ... 177 178

No comments

Raritan DOMINION SX - Specifications Page 153