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

A
PPENDIX
I: TCL P
ROGRAMMING
G
UIDE
119
Appendix I: TCL Programming Guide
Disclaimer: The information contained in this section is subject to change without notice.
Raritan shall not be liable for errors contained herein or for incidental or consequential damages in
connection with the furnishing, performance, or use of this material. Raritan assumes no responsibility for
the use or reliability of its software on equipment that is not furnished by Raritan.
Overview
Dominion SX supports TCL (version 7.0), an industry standard scripting engine. Using TCL scripting capabilities,
you can create customized conditions for event detection, and can generate customer-specific notifications and alerts.
Dominion SX features a TCL engine and a flash file system for the development and storage of TCL scripts.
Dominion SX is pre-configured with a set of User Definable Events that can be generated by TCL scripts. Raritan
has introduced an extension library to provide an API to Dominion SX’s functions. In addition, Dominion SX
includes an extensive list of notification events that can be used to audit, track, and trace the conditions of and
modifications to the unit itself.
This appendix describes the architecture and features of the TCL script engine, and provides information to help you
develop scripts to manage multiple remote target devices.
TCL Architecture with Target System
The following diagram illustrates the TCL Engine architecture:
GUI
Target
Write
Module
Target
Read
Module
Target
Buffer
Target
Buffer
TCL Users
Browser User
TCL Engine
Flash File System
Target System
"cat /tmp/file1\r"
"This is contents of file1\r"
Figure 124 TCL Architecture
Key aspects of TCL architecture:
•
The TCL Engine is single-threaded and shared across multiple users and target devices.
•
A browser user (standard GUI) does not interact with the TCL Engine.
•
The TCL Engine shares the same function blocks for accessing the console via the RS-232 port.
•
The TCL Engine does not interfere with normal console access function.
•
Only Administrators may operate TCL.