iTP Secure WebServer System Administrator's Guide (Version 7.0)

iTP Secure WebServer System Administrator’s Guide—523346-012
E-1
E
Tool Command Language (Tcl)
Basics
This section describes the basic Tcl concepts and language elements you need to
know to write iTP Secure WebServer configuration scripts.
iTP Secure WebServer configuration scripts are written in the Tool Command
Language (Tcl). It is important to note that any new directives you specify in the server
configuration file do not take effect until the server is restarted. (See Section 6,
Managing the iTP Secure WebServer Using Scripts.)
You configure the iTP Secure WebServer to your particular requirements by creating a
configuration script. This script contains a series of directives expressed in the syntax
of Tcl commands. The script sources in other files that you can customize to describe
the configurations of optional features like secure transport and Java servlet support.
For information about the nature and locations of all the configuration scripts, see
Section 7, Configuring the iTP Secure WebServer.
Although Tcl is a complete programming language, the subset of Tcl commands and
features described in this section is likely to be sufficient for most needs. Should you
require additional Tcl commands and features, you might want to refer to a Tcl resource
(see Bibliography on page -xxx).
To write a iTP Secure WebServer configuration script in Tcl, you need to understand
basic elements or concepts in each of these areas:
•
Tcl Syntax Rules on page E-1
•
Tcl Commands on page E-3
•
Script Commands on page E-4
Tcl Syntax Rules
A Tcl script consists of a series of commands and comments entered into a file. The
following syntactical rules apply:
•
A comment consists of any single line beginning with the pound sign (#).
Comments are not executed.
For example, the following four lines are comments and therefore not executed by
the Tcl interpreter:
#
# The following directive specifies the
# location of the server contents
#