APPENDIX I: TCL P ROGRAMMING G UIDE 119Appendix I: TCL Programming GuideDisclaimer: 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 inconnection with the furnishing, performance, or use of this material. Raritan assumes no responsibility forthe use or reliability of its software on equipment that is not furnished by Raritan.OverviewDominion 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. Raritanhas introduced an extension library to provide an API to Dominion SX’s functions. In addition, Dominion SXincludes an extensive list of notification events that can be used to audit, track, and trace the conditions of andmodifications to the unit itself.This appendix describes the architecture and features of the TCL script engine, and provides information to help youdevelop scripts to manage multiple remote target devices.TCL Architecture with Target SystemThe following diagram illustrates the TCL Engine architecture:GUITargetWriteModuleTargetReadModuleTargetBufferTargetBufferTCL UsersBrowser UserTCL EngineFlash File SystemTarget System"cat /tmp/file1\r""This is contents of file1\r"Figure 124 TCL ArchitectureKey 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.