APPENDIX H: TCL PROGRAMMING G UIDE 141amppermission, amplisten and ampresponse are commands to enable a TCL script to interact with otherTCL users.• amppermission − On will enforce permission checking.− Off will allow observers and operators to access TCL.• amplisten− Remember who sent the command and respond to the sender instead of the executer of the script.− If no command is present, amplisten returns a null.• ampresponse.− Flush the data in current result buffer (stdout) to the user.The extensions enable a TCL script/user to send notifications (SMTP) to subscribed users when an eventoccurs. The creator of the script is required to generate an event and users are given the option to subscribeto the event. Commands are provided for a script to send notifications to subscribed users when an eventoccurs. This appendix provides information on how to create and subscribe to an event.Boot Script SupportA mechanism is available to write scripts that will be executed when the system boots. The boot script is anormal script except that it should be named “boot.scr” (case insensitive). On factory reset, the boot.scrscript will be renamed to boot.bak automatically. After the factory reset, the user can make necessarychanges in the boot script (“boot.bak”) and rename it back to boot.scr.The boot script can access the RS-232 ports, but the user must insure that the write locks are releasedotherwise no user will be able to get write access to the console of the remote target device. In case a writelock is not released, the user has to change the boot script appropriately and perform a soft reset.File SystemDominion SX includes a general-purpose flash file system, which can be accessed by both the internal webserver and the TCL interpreter. The file system is MSDOS 3.3 compatible with 8.3 (xxxxxxxx.xxx) filename constraints and can be used to store TCL data and scripts. A total of 10MB is available for storage ofuser data. There is no specific limit on the size of a particular script or the number of scripts a user maysave.The file system is accessible only by the TCL engine and hence only Administrator users can modify thefilesystem (e.g. create, delete files etc). Operator and Observer users can be granted access to the TCLengine and hence to the filesystem by administrators through the use of the amppermission command.File Directory StructureAll user scripts and data are stored in /ata/usr. Access to all other directories in the system are restricted tothe user.File System API through TCLpwdDisplay current path.dir List directory contents.mkdir If absolute path is not provided, then the new directory is created in the present working directory.rmdir Remove the specified directory.
