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

A
PPENDIX
I: TCL P
ROGRAMMING
G
UIDE
121
•
Access control for TCL.
•
By default, administrators are the only users that can access TCL. However, administrators may disable the
check.
amppermission, amplisten and ampresponse are commands to enable a TCL script to interact with other TCL users.
•
amppermission <on/off>
−
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 event occurs.
The creator of the script is required to generate an event and users are given the option to subscribe to the event.
Commands are provided for a script to send notifications to subscribed users when an event occurs. This appendix
provides information on how to create and subscribe to an event.
Boot Script Support
A mechanism is available to write scripts that will be executed when the system boots. The boot script is a normal
script except that it should be named “boot.scr” (case insensitive). On factory reset, the boot.scr script will be
renamed to boot.bak automatically. After the factory reset, the user can make necessary changes 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 released otherwise no
user will be able to get write access to the console of the remote target device. In case a write lock is not released,
the user has to change the boot script appropriately and perform a soft reset.
File System
Dominion SX includes a general-purpose flash file system, which can be accessed by both the internal web server
and the TCL interpreter. The file system is MSDOS 3.3 compatible with 8.3 (xxxxxxxx.xxx) file name constraints
and can be used to store TCL data and scripts. A total of 10MB is available for storage of user data. There is no
specific limit on the size of a particular script or the number of scripts a user may save.
The file system is accessible only by the TCL engine and hence only Administrator users can modify the filesystem
(e.g. create, delete files etc). Operator and Observer users can be granted access to the TCL engine and hence to the
filesystem by administrators through the use of the
amppermission command.
File Directory Structure
All user scripts and data are stored in /ata/usr. Access to all other directories in the system are restricted to the user.
File System API through TCL
pwd
Display current path.
dir <directory name>
List directory contents.