New Features in Version 3.0 -- Tcl API

### Tcl API

The following features changes for the Tcl API are included in AOLserver Version 3.0:

Feature | Where Documented
--- | ---
ADP parsers supported: ADP parsers implement a specific syntax for ADPs. Two ADP parsers are registered by default: "adp" and "fancy". Configure ADP parsers in the ns/server/server-name/adp and ns/server/server-name/adp/parsers sections of the configuration file. You can specify a specific ADP parser in the ns_adp_eval Tcl function. You can register new ADP parsers with the Ns_AdpRegisterParser C function. | Administrator's Guide: page 56, page 57 Tcl Developer's Guide: page 10, page 53 C Developer's Guide: page 45
New ADP configuration parameters: Several new parameters have been added, and some other parameters have been removed. | Administrator's Guide: page 56
ADP caching configuration changed: Caching for ADPs is configured with the new Cache parameter in the ADP section. | Administrator's Guide: page 56
Built-in ADP tags no longer supported: The built-in ADP tags, <aol>, <browser>, <msie>, and <netscape>, are no longer supported. You can register your own ADP tags with the ns_adp_registertag and ns_register_adptag functions. | Tcl Developer's Guide: page 58, page 160
New/Modified ADP functions: The following Tcl functions are new: ns_adp_debug ns_adp_dump ns_adp_eval ns_adp_exception ns_adp_puts ns_adp_registertag ns_adp_return ns_adp_stream ns_adp_tell ns_adp_trunc The following Tcl functions are modified: ns_adp_abort ns_adp_break ns_adp_include ns_adp_parse | Tcl Developer's Guide: page 50 through page 62
ADP debugging with TclPro: TclPro debugging for ADPs can be enabled with the new EnableDebug parameter, or with the new ns_adp_debug function. | Tcl Developer's Guide: page 7, page 9, page 50
Some database services functions removed: The following database services functions have been removed: ns_buildsqldate ns_buildsqltime ns_buildsqltimestamp ns_column ns_entryform ns_entrywidget ns_entrywidgetbytype ns_ill ns_parsesqldate ns_parsesqltime ns_parsesqltimestamp ns_searchform ns_searchopwidget ns_searchqbf ns_table ns_updateform ns_updaterow ns_updaterowbyid | NA
Tcl caching changed: Tcl file caching is no longer configured through the configuration file. The ns_cache function has been removed, and a new set of caching functions has been implemented: ns_cache_flush ns_cache_names ns_cache_size ns_cache_stats. | Tcl Developer's Guide: page 67 through page 70
New configuration file Tcl functions: The new ns_section and ns_param Tcl functions are used to define the sections and parameters in the configuration file. The new ns_configsection and ns_configsections functions are used to return information from the configuration file. | Tcl Developer's Guide: page 76, page 77, page 145, page 182
Full Text functions removed: Illustra and the full text features of AOLserver are no longer supported. As a result, the following Tcl functions have been removed: ns_archivetable ns_hiliteurl ns_htmltoquery ns_textarchive ns_textconfigpath ns_texthandlepool ns_textindex ns_texttable | NA
Linked interpreters no longer used: Tcl interpreters no longer share the same procedure tables. During startup, a single interpreter, known as the parent interpreter, exists and is populated with procedures. After startup, the parent interpreter is copied into many child interpreters, each of which is assigned a connection thread. | Tcl Developer's Guide: page 29
Maintaining state data no longer supported: AOLserver no longer maintains state data in Tcl. As a result, the following Tcl functions have also been removed: ns_state_delete ns_state_restore ns_state_save ns_state_view | NA
Permissions functions modified: Six new permissions functions replace the old permissions functions. The new functions are: ns_perm adduser ns_perm addgroup ns_perm allowuser ns_perm denyuser ns_perm allowgroup ns_perm denygroup ns_perm checkpass ns_perm setpass ns_permpasswd The removed functions are: ns_group ns_method ns_user | Tcl Developer's Guide: page 150, page 152
Server statistics functions removed: The following functions have been removed: ns_intervalstats ns_resetintervalstats ns_totalstats | NA
New sockets functions: Four new sockets functions have been added: ns_sockblocking ns_socklistencallback ns_socknonblocking ns_socknread | Tcl Developer's Guide: page 196, page 201, page 202, page 203
Stored procedures supported: The following new functions have been added to support database stored procedures: ns_db sp_exec ns_db sp_getparams ns_db sp_returncode ns_db sp_setparam ns_db sp_start | Tcl Developer's Guide: page 88
New Tcl functions: The following functions not otherwise mentioned above are new for v3.0: ns_atexit: Register a script to be run at shutdown ns_checkurl: Authorize a request ns_cond: Manage events ns_conncptofp: Write content to a file ns_connsendfp: Write contents of file to conn ns_cport: Control port interface commands ns_gmtime: Return time in GMT form ns_kill: Send a signal to a process ns_logroll: Roll server log ns_markfordelete: Mark interpreter for deletion ns_menu: Administer server in control port ns_modlog: Send notice to the log ns_modlogcontrol: Define log realms ns_modulepath: Return server directory ns_parseheader: Parse HTTP header ns_parsequery: Parse querystring ns_querygetall: Get multiple query values ns_rand: Generate a random number ns_rollfile: Roll an arbitrary file ns_uudecode: Perform base-64 decode ns_uuencode: Perform base-64 encode | Tcl Developer's Guide: "Function Reference"
Removed Tcl functions: The following functions not otherwise mentioned above are no longer supported for v3.0: ns_accesslog ns_adminlink ns_browsermatch ns_formvalueput ns_htmlselect ns_parsetime ns_puts (use ns_adp_puts instead) ns_queryresolve ns_quota ns_updateheader | NA
Tcl v7.6 supported: AOLserver now supports the Tcl v7.6 commands instead of the Tcl v7.4 commands. Visit the http://www.scriptics.com/man web site for the complete descriptions of Tcl 7.6 commands. | www.scriptics.com/man
Tcl v7.4 no longer supported | NA

Top of Page
Copyright © 1998-99 America Online, Inc.